“i 
i 


aaa . ad : v3 y 
ea ie aie 


% 4” 


Go 


hoa 
the Internet Frotocals 


c FX 
C S 
Computer Science Facilities Group 


C I 


a Ss 


The State University of New Jersey 


9 


Sane LS? 


This is an introduction to the Internet networking protocols (TCR/ITF). 
Tt includes a summary of the facilities available arid bri et 
descriptions of the major protocols in the family. 


Copyright  (C) 1987, Charles L. Hedrick. Anyone may reproduce this 
dacument, in whole or in part, provided thats (Af tiny! “aayy. cH 
republication af the entire document must show Rutgers University as 
the source, and must include this motice; and (2) any ather use of 
this material must reference this manual and Rutgers University, and 
the fact that the material is copyright by Charles Hedrick and is used 
by permisesian. 


Unix is a trademark of AT&T Technologies, Inc. 


Ws ey Vasey 


TOPs IP protocols 


2s UDP and LOMF 
- of names and intormatioans the domain eystem 


about Internet addressee: subnets and broadcasting 
Ail Salles A and Pome 


Gina vie ‘ 
2 er A a 4 4 


==" 


aids ei +t + yi ovis 40 bees: 
| ge 3B 
Tavwl 
borvin ty iden 
Wal are} Sige Leroi gee Ey he Jahist 
TTB spokes he? Cane 
Met ee er aes a synthe 
» tan ma? thhb ia2eroens bie oe eT hey | ot ek 


4 | ewe 25 é Reb ara Aint is ert seagrit 
[dneeen= 9 WSR NO beta 
AG. 2no : tedies 

haripmenostnt 


wh Were > 
: mt he S ty hu 7 
A ea af mn rc ie 
Tras vA oy oe 


This document is a brief introductian to TCP/IP, followed by advice an 
-what to read tor more information. This is not intended to he a 
es deseriptian. tt can give you a reasonable idea of the 
i. abilities of the protocols. But if you need to know any details of 
the technology, you will want to read the standards yourself. 
Throughout the text, you will find references to the standards, in the 
form of "REC" or "TEN" numbers. These are document numbers, The final 
Section of this document tells you how to get copies of those 
standards. 
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TCP/IP is a set of protocols developed to allow cooperating computers 
to share resources across a network. tt was developed by a cammunity 
of researchers centered around the ARFAnet,. Certainly the ARFAnet is 
the best-known TCR/TIFP network, However as of dune, &7, at least Low 
different vendors had products that support TCFE/IFP, and thousands of 
networks of all kinds use it. 


First some basic definitions. The most accurate name for the set of 
protocols we are describing is the “Internet pratocol suite". TCr and 
TP are two of the protocols in this suite. (They will be described 
below. ) Because TCF and IF are the best known of the protocalis, ait 
fae geeome common to wee the term TCPYIPoor IF/TEP) tosi refer to the 
whole family. It is probably not worth fighting this habit. However 
D: can lead to some oddities. For example, I find myself talking 

rout NFS as being based on TCP/IF, even though it doesn’t use TCR at 
all. (It does use IP. But it uses an alternative protocal, UDF, 
instead of TCE. 11 of this alphabet soup will be unscrambled in the 
following paqes. } 


The Internet is a collection of networks, including the Arpanet, 
NSFnet, regional networks such as NYsernet, local networks at a rns er 
af University and research institutions, and ai number of military 
networks. The term “Internet” applies to this entire set of networks. 
The subset of them that is managed by the Department of Defense is 
referred to as the "DDN" (Defense Data Network). This includes some 
research-oriented networks, such as the Arpanet, as well as more 
strictly military ones. (Hecause much of the funding for Internet 
protecol developments ig done via the DDN organization, the terms 
Internet and DDN can sometimes seem equivalent.) All of these 
networks are connected to each other. Users can send messages from 
any @f them to any other, except where there are security ar ather 
Polley restrictions on access. Officially speaking, the Internet 
protocol documents are simply standards adopted by the Internet 
community for its own use. More recently, the Department af Deteanse 
issued a MILSPEC definition of TCF/IF. This was intended to be a mare 
| formal definition, appropriate for use in purchasing specifications. 
| However most of the TCEYIF community continues to use the Internet 
.. standards. The MILSPEC version is intended ta be consistent with it. 


PD stever it is called, TCP/IP is a family of protocols. A few provide 
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“Low-level” functions needed tor many applications. These include IP, 


TCR, 


and UDF, iThese will be described in a bit more detail later.) 


i ers are protocols for doing specific tasks, @.g. transferring files 
ween computers, sending mail, ar finding aut who is flogged in on 


another camputer. Initially TCP/TF was used mostly between 
minicomputers or mainframes. These machines had their own disks, anc 
generally were self-contained. Thus the most important “traditional” 
TCR/IF services ares 


file transfer. The file transfer protocol (FTP) allows a user oan 
any computer to get files from another computer, or tao send files 


‘to another computer. Security is handled by requiring the user 


to specify aA user name and password for the other camputer., 
Provisions are made for handling file transter between machines 
with different character set, end of line conventions, etc. This 
is not quite the same thing as more recent "network file syatem” 
or "“netbios” protocols, which will be described below. Rather, 
FTF ig a utility that you run any time you want to access a tile 
on anather system. You use ait ta copy the file to your own 
system. You then work with the local copy. eee LiREG. (Sao o cfr 
epecifications far FTF.) 


remate login. The network terminal protecol (TELNET) allows a 
user to log in on any other computer on the network, You start a 
remote session by specifying a camputer te connect to. From that 


“time until you finish the session, anything you type is sent to 


the other coamputer. Note that you are really still talking ta 
your own computer. But the telnet program effectively makes your 
camputer invisible while it is running. Every character you type 
is sent directly toa the other system. Generally, the cannmectian 
to the remote computer behaves much like a dialup cannectian, 
That is, the remote system will ask you to iog in and give a 
password, in whatever manner it would normally ask a user who had 
just dialed it up. When you log off of the other computer, the 
telnet program exits, and you will find yourself talking toa your 
own computer. Microcomputer implementations of telnet generally 
include a terminal emulator for some cammon type of terminal. 
(See RFC’s 854 and SSS for specifications for telnet. By the 
way, the telnet protocol should not be confused with Telenet, a 
vendor of commercial network services.) 


computer mail. This allows you to send messages to users on 
other camputers. Griqginally, peaple tended to use only ane ar 
two specific computers. They would maintain "mail files" an 
these machines. The computer mail system is simply a way for you 
to add a message to another user's mail file. There are some 
problems with this ain an envireanment where microcomputers are 
used. The most serious is that a micro is not well suited to 
receive camputer mail. When you send mail, the mail software 
expects to be able to open a connection to the addressees 
computer, in order to send the mail. if this is a microcomputer, 
it may be turned off, or it may be running an application other 
than the mail system. For this reason, mail is normally handied 
by a larger system, where it is practical to have a mail server 
running all the time. Microcomputer mail software then becomes a 


™ 


we 


OS gee TE 


user interface that retrieves mail from the mail server. (ee 

RFC 821 and G22 for specifications for computer mail. See RFC 
Gay for aoprotacoal desiqnedd for microacamputers ta use in reading 
a) mail from & mali server.) 


These services should: be present in any implementation of TOR/SIP, 
except that micrea-oariented implementations may mot support computer 
mail. these traditicanal applicahions etill play a very important role 
in TCR/iFP-based networks. However more recentiv, the way in which 
networks are ugedc has been changing. The older model of a number of 
large, self-sufficient camputers is beginning to change. Now many 
installations sever al kinds cr computers, including 
microcomputers, miniconputers, and maintrames. Theee 
camputers are to be configured ta perfarm specialized tasks. 
Although people are shill likely to work with one specific computer, 
that computer will cali oan other systems on the met fer epecialized 
services. This has dled to the “server/client’ madel of  metwert 
Servi ces. A server is a system that provides a gepecific service far 
the rest of the network. A client is another system that 
Service. (Note that the server and client need not be on differant 
coamputers. They could be different programs running on the same 
computer.) Here are the kinds of servers typically fant in a 
modern camputer getup. Note that these computer services can all he 
pravided within the framewark of TCrRYSTF., 


that 


~—network file systems. This allows a system to access files an 
another camputer in 4a somewhiah mare ol Live Dy ire rated fashion 
than FTF. A network file system provides the iliusicon that disks 
d or other devices from one system are directly connected ta other 
| systems. There is no need to use & special network utility to 
access a file on another system. Your camputer simply thinks ait 
mas sane extra disk drives. These extra “virtual” drives refter 
Poeeie other. systems disks. This capability is useful for 
gaye al different purposes. it lets you put large disks on a few 
computers, but etill give others accese to the disk space, Aside 
fram the obvious economic benefrits, this allows people working an 
several camputers ito share cammon files. it makes : 
maintenance and hackup @agier, because you dan’t have to worry 
about updating and hacking up copies an lots of difterent 
Machines. A mumber of vendors now offer high-performance 
disklessa computers. These computers have mo disk drives at all. 
They are entirely dependent upon disks attached ta cammon "file 
sevens (See RFC'’s i@@1 and i882 for ai descriptian af 
FC-oriented Met eis Oy eH" cow oe In the workstation and 
minicamputer area, Sun's Network File System is mare likely to be 
Lich Feotacal epecifications for it are available from Sun 
Micrasystems. ) 


-— remote printing. This allows you toa access printers oan other 
computers ag if they were directly attached to yours, (The most 
caomnaniy used protocol is the remote Lineprinter protecol from 
Berkeley Unix. Unfortunately, there is no protecel document far 

» this. However the ( code ig @agsily abtained fram Berkeleay, so 
9D implementations are cammon.) 
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remote execubhion., This allows you to re particu ae 
pragranm be run an a different computer. Th: wher  yvCul 
can do most of your work on a emall computer, but a tew tasks 
require the resources of a larger system, There are a number of 
different kinds of remote execution. Same aperate on a cammand 
by cammand bhagis. That is, you request that a Specific command 
or seb of commands should run on some apecific camputer. (Mare 
sophisticated versions will choose a system that happeng to 38 
free.) Hawever there are alsa “remote procedure call” systeme 
thet allow a program to call a subroutine that will orun on 
another computer. (There are many protocols of this sart. 
Berkeley Unix contains two servers to execute commands remotelys 
rPeh and renxec. The man pages describe the protocols that they 
use, The user-contributed saftware with Berkeley 4.2 contains 
“Mdistributed shell" that will distribute tasks among a se or 
eystems, depending upon load. Remote scedure call ‘mechanisms 
have been a topic for research for a mumber of years, SO many 
arganizations have implementations of such facilities. The most 
widespread commercially-supparted remate procedure call protocals 
seem to be Xerox’s Courier and Sun’s RFC. Protocol documents are 
Available fram Xerox and Sun. There ig a public implementation 
of Courier over TCF as part of the user-contributed Mtware with 
Berkeley 4.3. an implementatian of RFC wae posted to Usenet by 
Sun, and also appears as part of the user-contributed sattware 
with Berkeley 4.°5,.) 


is 


we 


name servers. in large installations, there are a number of 
different collections of names that have to be managed. This 
in¢ludes users and their pasewords, names and network addresses 
for camputers, and accounts. it becomes very tedious to keep 
this data up to date on all af the computers. Thus the t : 
are kept on a small number of systems. Other systems access 
data over the network. (REE 2 and 82% describe the name server 
protocol used to keen track of host mames and Internet addr = 
om the Internet. This if now a required part of any TCP 
implementatkian. TEN 1146 describes an alder name server protocol 
that is used by a few terminal servers and other products to look 
up host names. Sun's Yellow FPages system is designed as a 
general mechaniam to handle user names, file sharing groups, and 
other databases cammonly used by Unix systems. Tt 28 widely 
available cammercially. tts protocel definition is available 
miro Sur.) 


terminal servers. Many ingtallations no longer connect terminals 
airectiy to camputers. instead they connect them toa terminal 
servers. A terminal server is simply a small computer that only 
knows how toa run telnet (or some other protacal toa do remote 
Wega ky) « If your terminal is connected to one of these, you 
simply type the name of a computer, and you are connected eo aes 
Generally it is possible to have active connections ta mare than 
one computer at the same time. The terminal server will have 
provisions to switch between cannections rapidly, and ta notify 
you when output ais waiting for another connection. (Terminal 
gervers use the telnet protoceal, already mentioned. However any 


‘real terminal server will also have to support name service and a 
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number of ather pratocoals.> 


™—\ ~ network-oriented windaw systems. bleed), recently, nian 
a) performance graphics programs had to execute on a computer that 
had a bit-mapped graphics screen directly attached to it. 
Network window systems allow a program to use a display on a 
differant computer. Fulle-scale network window systems provide an 
interface that lets you distribute jobs ta the systems that are 
best cuited to handie them, but still give you a single 
qraphically-based user interface. ithe most widely-implemented 
window system is X. A pretocel description is available fe cat 
MiT’s Froject Athena. A reference implementation ie publically 
available from MIT. A number of vendors are also supporting 
NewS, a window system defined by Sun. Bath of these ayatemns are 
designed tao use TCR? 


Note that some of the protocols described above were designed by 
Berkeley, Gun, or other organizations. Thus they are nob officially 
part of the Internet protocol guite. However they are implemented 
Using TOP/IF, just as normal TCR/IF application protocels are. Since 
the protocol definitions are not considered praprietary, and since 
commercialiy-support implementations are widely available, it is 
reasonable to think of these protocols as being effectively part of 
the Internet suite. Note that the lish above is simply a sample aft 
the sort of services available through TCR/IF., Hawever it does 
contain the majority of the "major" applications. The other 
commonly-used protocole tend to be specialized facilities tar getting 
information of various kinds, such as whe is logged in, the time or 
a » @tc. However if you need a facility that is nm ot listed here, we 
Meeoursege you to look through the current edition of internet 
Protocols (currently RFG 1@11), which lists all af the available 
protocels, arc aleoa te Look atuasome.of4othe- major TCP/IP 
implementations to see what various vendoare have added. 


®, General description of the TCP/IP protocals 


TCR /IF is a layered set of protocols. in arder to understand what 
this means, it is useful te look at an example. A typical situation 
is sending mail. First, there is a proteacol for mail. This defines a 
get of cammands which one machine sends to another, @.g. Ccammands to 
apecify who the sender of the message is, who it i6 being gent ta, and 
then the text of the message. However this protocol assumes that 
there is a way to communicate reliably between the two camputers. 
Mail, like other application protocols, simply detines a get cf 
commands anc meseages toa be sent. tt is designed to be used together 
with TCE and IP. TCE is responsible for making sure that the commands 
get through to the other end. tt keeps track of what is sent, and 
Yetransmitts anything that did not get through. i+ iy meegage is tac 
large for one datagram, e.g. the text of the mail, LES 13.4 diye 804 4a ak 
up into several datagrams, and make sure that «they).add arrive 
srractiy. Gince these functions are needed for many applicahioang, 
By are put together into a separate protecal, rather than being part 


a 
tut 


oOnse ; 


reget THOAIGBN » Leo, hae <7 
i 


fh. Paty 


yy 
ide lige ey ae dw 
i asu2axe oF fas ame wun y i 
yihom vidgonenib  gerise BEM CAA IO) Burs 
bs OF PRYOR AG ni? wend ip & om t ae 
re ve woborm Sewn 4ener hiary > 
ate wit of ado, seeing Pao woy a2 
S ip i pace ut i * Lone 
qa! indbiw Jeon gery 56 ana? a wir). 
oe | fh. Valin .4aHeeay fooo rey » he 
chi siFa Jno ‘i wenersten Ae .acrerit Pele He 
s 856 wwbCew. to, eam A oS TERne 
» & MQ pat ena) vd ben lee oa tayaowegir ow 
7 L.SIN\9DT ea oF, 
1 vote vetineesh .el@sntow , ante ery 
j ferize Bit! ns wlder feegoo werida e ’ 
it ay VAP m7 twa Scrugrang tan: edok 
is Mitmnoilegga MING hemor ae » Saale ts 
, "2. bieoidbetarion ‘anh @e°7m arort aot the 
shite La eKiottaynans lam) gq): 
wired #«@ wlesasorvd, event to shea bet 7: 
woda SAL aan fans : hoa -@7 wea is 
rae 9) ‘pte ah? vibes lisva #epivam 
; : \s ot sar” an? Ke wince. .- ; 
t iin coeage i op Booed losnose ig the 
4 beng zt oOflw me i » FRAY ety wey +a 
yt t tar 4ilioaer «4. Geen ‘i 2AaVvow 
roe wa sie ay 
{ 5 Fit ,» (tra —) vie 
| moe up ice) oy get 
tot ari 4 urttiyv Boy Wey hoiw 208 9° ee 
90 fete 4g it\S1 ec Vit. as Fares oe 
i. 
ie bri 7), -elogotan) to. das Bare yA 
La 1G Hl LOMRaMe Me. Te inn i aF isha, sa 
: “2 [nsqio id € & > 0 eh ie Bes 
g.o 48 we of ahase soins aro A ad 7 
‘py 4 #: 22 off gas PPpARRaa. ars 70).'% mer 
foaso7oNg gi sewer »SPSRQe an - att, . 
7 are Be 1A oaw tea (idet.e% BaD Presta 
ranicob yignta . vetometaag Wet te Ae 74 
; a banpiedk eh af . Shee, on ae 
' Jet? wie ofitem- teat @ic PEO MT 
~ re] jaciw@ 470 ASM #4usaN vr. ~~ hija Sin : 
n2eo ‘oe 4 iow + Te ton oth 
il 49 tiki wt to sxad wad” 
ie . art jet? @fhue eiem DAR 
\faqa vnam. ot babeer PH ENN EEA 


for sueh @-bit chunks. The term “byte” is not use 


of the specifications for sending mail. your Gan Sink “Or “TCR “as 
forming a library of routines that applications can use when they a 

liable network communications with another computer. SLM Lary. 

ise an the services of —[F. Although the services that TOF supplies 
are needed by many applicatians, there are still some kinds of 
applicatians that don’t need them. However bhere are sane services 
iat every application needs. So these services are put together inte 
6 aa Ae with TCP, you can think of IP as a dibrary of routines that 
TCP calis on, tub which is alec available toa applications that dan‘t 
use TC. This strateqy af building Several levels of protoceal 
called “layering”. We think of the applications programs such as 
maii, iTCF, and IF, as being separate “layers”, gach of which calle an 
the services of the layer below it. Generally, TCR/TF applications 
use 4 layrmrse: 


“an application protoeceal such as mail 


~ @ proetacol such ag TCP that provides services need by many 
Pee inne 


—~ Tr, which provides the basic service of getting datagrams to 
their destinatian 


~ the protocols needed ta manage a specific physical medium, such 
aS YF: ethernet or a point to point line. 


TCE/TFP is based on the "“catenet model”. (Thies is described im omare 
detail in TIEN 48.) This model assumes that there are a large number 


2» independent networks connected tagether by <cqateways. The uger 
o 


wid be able to access computers or other resaurces on any Gf these 
networks. Datagrame will oaften pass through a dozen different 
networks before getting to their final destination. The routing 
needed ta accomplish this should be campletely invisible to the user. 
Se far as the user is concerned, all he needs to know in order to 
access another system is an "Internet address". This is an address 
that looks like 125.6,4. 194, Tt if actually a Se-bit mumber. However 
it is normally written as 4 decimal numbers, each representing & bits 
of the address. (The term "octet" is used by Internet documentation 
ad, because TCRP/IF is 
supported by same computers that have byte sizes other than & bits.) 
Generally the structure of the addrege gives you same information 
about how to get to the system. For example, 128.6 is a network 
number assigned by a central authority toa Rutgers University. Rutgers 
Uses the mext oactet to indicate which of the campus Ethernets is 
involved. 128.6.4 happens to be an Ethernet used by the Computer 
Science Department. The last octet allows for up to 254 systems oan 
each Ethernet. (It is 254 because @ and 255 are mot allowed, far 
reasons that will be discussed later.) Note that 126.6.4.194 and 
1268.6.5.194 would be different systems. The structure of an Internat 
address i¢ described in a bit more detail later. 


Of course we normally refer to systens by mame, rather than hy 
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internet address. When we specify a name, the network software laoks 

: up in a database, and cames up with the corresponding Internet 

SFHiress. Most of the network software deals strictly in terme of the 
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acicdress. (REC Bee describes the name server technalogy uged to handie 
this lookup.) 


Bete is built on "coannectionle technology. Infarmatian i6 
transfered as aA sequence of "datagrane”. A datagram is a collection 
of data that is sent as a single me age. kach of these lat aque eames Ls 
sent through the metwork individually. There are provisions to open 
cannectioangs t1.€. to start a coanversation that wild cantinue Fone Sime 
time). However ah some level, information fram those connections is 
Braken up into datagrams, and those datagrams are treated by the 
network as completely separate. For @xample, suppase you want to 
transfer a iS@ad octet file. Most networks can’t handle a 1LOGiag octet. 
datagram. So the protocels will break this up inta something like 
wO@-octet datagrams. Each of these datagrams will be sent to 
ether end. At that poimt, they will be put back together inte 
ISWa@G—-octet file. However while those datagrams are in transit, 
network doe@an’t knew that there is any canmectian between them, itiis 
perfectly possible that datagram i4 will actually arrive before 
datagram 13. tt is alsa possible that samewhere in the network, an 
error will occur, and some datagram won't get through at all. In vist 
cage, that datagram has toa be sent again. 


Note by the way that the terms “datagram” and “packet” often seem to 
be nearly interchangable. Technically, datagram ig the right word to 
use when describing TCF/IF. A datagram 18 a unit of data, which is 
what the protecois deal with. A packet is a physical thing, ap 
anoanm Ethernet ar some wire. in mast cased a packet Simply contains a 
datagram, soa there is very Little difference. However they can 
Ore: When TCF/IF is used on top of K.25, the K.25 interface breaks 

@ datagrams up into lf@-byte packets. THis ais ainvisible to. IP, 
because ithe packets are pub back together inte a single datagram at 
the other end before being pracessed by TC SOQ im this case, ane 
IP datagram would be carried by several packets. However with most 
media, there are efficiency advantages ta sending one datagram per 
packet, and so the distinction tends to vanish. 


fel The TCF level 


Two separate protocols are involved in handling TCF/TP datagrams. TCP 
{the “transmission control protacol”) is responsible for breaking up 
the message into datagrams, reassembling them at the other end, 
regending anything that gets lost, and putting things back in the 
right order. IF (the “internet protocel”) is responsible for routing 
individual datagrams. It may seem like TF 3 doing ali the work. 
And in small networks that is true. However in the Internet, simply 
getting a datagram to its destinatian can he a camplex job. a 
ecennection may require the datagram to ga through several networks at 
Rutgers, & serial line to the John von Neuman Supercomputer Center, a 
couple of Ethernets there, a series of Sékbaud phone lines to another 


if 


WNSFret site, and more Ethernets on another campus. FEeeping track of 


) ¥ routes to all of the destinations and handling incompatibiliti 
if 


ng different transport media turns out to be a campl ex weiss hater 
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hands IF a datagram with a esti nation. Ie doeean’t ince how this 
it relates to any datagram before it or after it. 


that the interface between TCF and IF is fairly simple. TCP simply 


may have occurred to you that something is missing here. We have 
le about Internet addresses, but not about how you keep track ct 
multiple connections to a given system. Cleariv it isn’k enough to 


get a datagram to the right destination. TCP has to know which 
cannection this datagram is part af. This task 15 referrced to as 
See ering. | In fact, there are several levels of demultiplexi 
Going on in TCR/ITF The information needed ta do this demultiplexing 
is contained in a Lehi ce of “headers”. A header if simply a few extra 
ectete tacked onto the beginning of a datagram by same proteaceal in 
order to keep track of it. {t's a lot like puttifig a letter ante an 
envelope and putting an address on the outside of the envelope. 
Except with modern networks it happens several hime. i aa a 8 i gL 
put the letter into a little envelope, youu ee putes that inta a 
samewhat bigger envelope, the campus flail center puts that envelope 
into a still bigger one, etc. Here is an overview of the headers that 


get stuck om a meseage thal passes through a typical TCP/IP networks 


We start with a single data stream, say a til@® you are trying to send 
to some other computer: 
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TCR breaks it up into manageable chunks. (In ‘order to do this, TC 

Hae to know how large a datagram your network can hari l @ . Actually, 

a. at each end say how bhiq a datagram they can handle, and then 
@y pick the smallest size.) 
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TCE puts a header at the front of gach datagram. This header actually 
contains at least @@ octets, but the most important ones are a Source 
and destination "port number” and aio "sequence munis ee The part 
numbers are used to keep track of different conversations. Suppose 3 
different people are transferring files. Your TOF might allocate part 
numbers 1@@@, 1@@1, and lite ta these transfers. When you are sending 
a datagram, this becomes the “source” port number, since you are the 
source of the datagram. Of course the TCF at the other end has 
assigned a port number of its awn far the conversation. Yer hore) as 
to know the port number ange by the other enc as well. ey Birid scot 
whan the conmnmection starts, as we will explain below.) tine mote ath s 
in the “destination” fee field. Of course if the other end sends a 
datagram back to you, the source and destination port numbers wiil he 
reversed, since then it will be the source and you will be the 
destination. Each datagram has a sequence number, This is used sa 
that the other end can make sure that it gets the datagrams in the 
right order, and that it hasn’t missed any. (See the em 
specification for details.) TCE doesn’t number the datagrams, but the 
octets. So if there are 5@@ octets of data in each datagram, the 
first datagram might be numbered @, the second S@@, the next 14@@, the 
Tie SOO. etc. “Finally, I witt mention the Checksum. This 16 a 

gly that is computed by adding up all the octets in the datagram 
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aoe eee eee tne TL Bpect. he result i¢ put in. the header. 
TCR at the other end camputes the checkeum again. If they cigagree, 
teen something bad happened ta the datagram in transmission, and it is 
(ae away. 60 here’s what the datagram looks Jike now. 
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if we abbreviate the TCE header as "T", the whole file now looks like 
this 
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You will mote that there are items in the header that =f have not 
described above. They are generaliv aunvelved with managing the 
fein tin order to make sure the datagram has arrived at its 
Gestination, the recipient has toa send back an “acknowledgement”. 
This is a datagram whose “Acknowledgement mumber” field is filled in, 
ene sxample, sending a packet with an acknowledgement ar j 
indicates that you have received all the data up ta actet number 15€ 
If the sender doesn’t get an acknowleddement within a reasonable 
amaunt of time, it sends the data again. The window i168 usedc 
centrol how much data can be in transit at any one time. Chad Se TEE 
practical to wait for each datagram to be acknowledged befare sending 
the mext one. That would slow things down too much. On the other 
hand, you can’t just keep sending, or a fast computer might overrun 
tthe capacity of a slow one ta absorb data. Thus @ach end indicates 
how much new data it is currently prepared to absorb by putting the 
number of octets in its "Window" field. Ag the computer receives 
data, the amount of space left in its window decreases When ib oe 
to zero, the sender has to stop. As the receiver processes the data, 
it increases its window, indicating that it is ready to accept more 
data. Often the same datagram can be used to acknowledge receipt of a 
set of data and to give permission for additional new data (by an 
updated window). The "Urgent" field allows one end to tell the other 
to skip ahead in its processing to a particular octet. This is often 
useful for handling asynchronous events, for example when you type a 
control character or other command that interrupts output. The other 
wields are beyond the scape of this document. 
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2.2 the IF level 
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a} sends each of these datagrams to IF. Of course it has to tell IF 
the Internet address of the computer at the other end. Note that this 
is all TF is concerned about. Tt doesn’t care about what is in the 
datagram, or even in the TCr header. tes yoo 28 “simoly to “Find a 
route for the catagram and get it to the other end. in order ta allaw 
gateways or other intermediate systems to forward the datagram, it 
adds its own header. The main things in this header are the source 


ser ety os 


and destination Internet address (Si-bit addresses, like 126.6.4.194), 
the protocol number, and another checksum. The source Internet 
address is imply the address of your machine, (This is necessary sa 
the other end knows where the datagram came from.) The degthination 
Internet address is the address of the other machine. {This is 
Necessary so any gateways in the middle know where you want the 


Getecram t6 go.) The protocol number tells IP at the other end toa 


Send 9the datagram “to TCE. “Although most IF traffic uses TCR, there 
are other protoecals that can use IP, so you have ta tell TF which 
peatocol toa send the datagram ta. Finally, the checksum allows Lr eet: 
the other end to verify that the header wasn’t damaged in transit. 
Note that TCE and IF have separate checksums. TP needs to be able ta 
Verify that the header didn’t get damaged in transit, ar it could gen 
a message to the wrong place. For reasans not worth discussing here, 
jt is both more efficient and safer to have TCE campute a separate 
checksum for the TCE header and data. Qnce [FP has tacked on its 
header, here’s what the message looks Likes 
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If we represent the IF header by an "I", your file naw looks like 
this: 
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Again, the header contains some additional fields that have nok been 
discussed. Most of them are beyond the scape of this document. The 
flags and fragment offset are used to keap track of the pieces when a 
datagram has ta be split up. This can Fappen when datagrams are 
forwarded through a network for which they are too big. (This wiil be 
discussed a bit more below.) The time to live is ao number that is 
cremented whenever the datagram passes through a system. When it 
es to zero, the datagram is discarded. This is done in case a Loop 
1@ 


> penis 


af a y.' 
are OY Ke +" 
oS se 
pale ri ro cae i) 2 
at Sys) ae : 
‘ , ; - , gard 45 - 
fia? of ean 32 Sanson” tO iT. at ere pied diseels 

it pent -es0y bow weatitod enqk Je Pebtess Red te aeevbe 
I fadiw F008 ae) 3° eae > Oreve STD bf 2 
ty ot’ Vigmnte @8F Got Bi fhe Sar, may 0) cave 
ry yao TT] bos watt ant _of-.r2 Tre { m me eetad ar 
job ett bradwu “os aeneryave wre leene ia? eS ae 


sid ee neh aidd mab eoritds nian od” : sy OD mK 
: ..06.-8C! atil ,aonpevbue 3 icd-S2) Haarbba terms, 1 Pi ors 
merry] @LK er! mu e@AQers ar GAS oe. , THN a re 
yisweoruad @&f areti eninvoag oy tO Baawhps writ nia 
irianriewth wri { . ie } may m5 IDs tab edd Sxenw wwcirtn 
brit) “4 vecto. oft to e2Realhie ai? at seee 
} anary wn clbbiW antf ob Bvewsine vee oe 
n into Y= “i eltatd sedmun Lesetosd wat (ue 
Pe he a ee oo 2 ef Sf teom puerta Sa) ‘oF ma “oe 
rt “4 fies i event voy oe 2 waw wan. Fane wlapote 
Lf, moetowonm ett ~vilisela .g2a ne tpetes et? Ghee ee 
‘ ¥ mig ) r now *ebaenr pas Art W? 1 Serv at 1 
in €0 oF 3 a4 er gtoerds afa teases evan Sl tee So 
yin 6S “K) 4 i 2379 ob DaDpenisay Lo 4) j Wib »ebeia ce 
pavuoe fh. ¢ y Jon enéeadn od  ~aaela gooiw ap Bae 
el wonm 3 ee eval o7 ee Dre tnvinteoe « 
mn ! gad 41 esr aime lik Seber FT.) Crt (ae 
reach eto) teacaegm ech Jere 7 2 
7 8 
me hoods etree Sn A ee ee sen ead steel Ateode steele ahathe Bix tole set ie shoeihh Aimee dickies bor 
$4) roid $O7 lediv~es® 40 @QVT! “eee 
spond mea ee ing ee ee ed es eee ea ad —— + 
sa>+*tO creamge (agen [4 ADisa274 rneit i 
4 ‘ a , a andy 4 he on me pe tf iw oe te ofp lp dome ne pe opr ei te eens fom 
eye 4) & a4 { Loso 754 ti ave oF : 
5 Gin ee | a wenny ere Vee ee {ene Soo See teen ee oe ee Se ere er ee Ce Py 
SaeDwA ose 4 ‘' 
4 re 4 4 ‘ én oid > ow abt ele aie 4 Ps ee ee ee ee ee ee ee 
eetnbhs 36) Mn ited 7 a 
en on ee ee te Rr ces atin ad sterol Py ee eS ere etE 


weve SIOD Wwoy Peet, .Aebey 
j hoc f wide be wo <I" aA vo Aeheed SP 


“nv cee Eh OP nga TRE! Sie eee es THe 


ied tart even ted’ eb het? Lanett rhoa ene ai ies 
iT neniioob etrd %o euCme- end Hneyved em 
, inde eengse ef to 49047 Geee 7? Deel ata) fun 
; one Oe tad ryan Me MraqQeay Was crnyT teeth 
twierdT)  vekd HOF eve v a tl, ao ¥ oe 
; ig 4S cine & er avis ents ant ¢ 
aL Th ma 72Ke - aes nw? yNewRg Retest 
a 4aa2 Ab aneh af erat aba ave ib er 


develops in the system somehow. Of course this should be impossibie, 
but well-designed networks are built to cope with YEmpossible"” 
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At this point, it‘s possible that no more headers are needed. i£.. your 
computer happens ta have a direct phone line cannecting it toa the 
Geetination computer, or to a gateway, it may Simply send the 
datagrams out on the line (though likely a synchronous proatoceal such 
as HDLC would be used, and it would add at least a few octets at the 
beginning anc end). 
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ze The Ethernet level 


However most of our networks these days use Ethernet. Sa now we have 
to describe Ethernet‘’s headers. Unfortunately, Ethernet has its own 
addregses. The people who designed Ethernet wanted to make sure that 
mo two machines would end up with the same Ethernet address. 
Furthermore, they didn’t want the user to have to worry about 
assigning addresses. So each Ethernet controller comes with an 
address builtin fram the factary. In order to make sure that they 
would never have to reuse addresses, the Ethernet designers allocated 
48 bits for the Ethernet address. Feoaple who make Ethernet e@cuipment 
have to register with a central autherity, to make sure that the 
numbers they agsiqn don’t averlap any other manufacturer. Ethernet a6 
& “Broacicast medium”. That is, it is in effect like an old party jiine 
ip ephone. When you send a packet aut on the Ethernet, every machine 
o the network sees the packet. So something is needed ta make sure 
that the right machine gets it. As you might quess, thie involves the 
Ethernet header. Every Ethernet packet has a l4-octet header that 
includes the source and destination Ethernet address, and a type code. 
Each machine is supposed to pay attention only to packets with its own 
Ethernet address in the destination field. {It's perfectly ible 
to cheat, which is one reason that Ethernet communications are mot 
terribly secure.) Note that there is no connection between the 
Ethernet address and the Internet address. Each machine has to have a 
table of what Ethernet address corresponds to what Internet address 
(We will describe how this table is constructed a bit later.) 
addition to the addresses, the header contains a type cade. The 
Code is to allow for several different proatocal families to be used 
the same network. So you can use TCP/IP, DECnet, xerox No, etc. 
the same time. Each of them will put a different value in the type 
field. Finally, there is a checksum, The Ethernet cantroaller 
computes a checksum of the entire packet. When the other end receives 
the packet, it recomputes the checksum, and throws the packet away a 
the answer disagrees with the original. The checksum is put on the 
end of the packet, not in the header. The final result is that your 
message loaks like thi: 
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{f# we represent the Ethernet header with "EE", and the Ethernet 
checksum with "CC", your file mow looks Like thigs 
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When these packets are received by the other end, of course all the 
headers are removed. The Ethernet interface removes the Ethernet 
header and the checksum, Tt looks at the type code. Since the type 
cade is the one assigned ta IF, the Ethernet device driver passes the 


datagram up to IF. IF removes the IF header. tL Pr oore “at thew iF 
the 


(@etocel field. Sence Lae oeororor “type ve TCR, - bt 

atagram up to TCP. TOF now looks at the JUeENnce Muamber ia 
the sequence numbers and other information to combine all 
datagrams into the original file. 
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The ends our initial summary of TCRP/TIF. There are still some crucial 
cancepts we haven't gotten to, so we'll now go back and add detaiia in 
several areas, (For detailed descriptions of the items discusse 
pee te a FOr Te ORE UPS ter Try and RFC’s o64 and 
sending TF aver Ethernet.) 
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oa. Well-known sockets and the applications layer 


So far, we have described how a stream of data i¢ broken up into 
datagrams, sent to another camputer, and put back together, However 
something mare is needed in order toa accamplish anything useful. 
There mas to be a way far you to open a connection to a specitied 
Gamputer, 1oq into it, tell it what file you want, and’ cantrol the 
transmission af the file. (if you have a different application ain 
mind, @.g. computer mail, some analogous protocol is needed.) This is 
Podone by “application protocols". The application protocols run "on 
D€op" of TCP/IP. That is, when they want to send a message, they give 
fme message to TC. TCR makes sure it gets delivered ta the other 
No . Because TCP and IF take care of all the networking detaiisc, the 
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applications proteacois can treat a network cannectian as if it were & 
simple byte stream, like a terminal or phone line. 


@..-. qoing inte more details about applications programs, we have ta 
describe how you find an application. Suppose you want to send a file 
to a computer whose Internet address is i2e.6.4.7, To start the 
nrecess, you need more than just the Internet address. You have ta 
cannect to the FTF server at the other end. In general, network 
programs are specialized for a Specific se of bagke, Mosh systems 
have separate programs toa handle file safers, remote terminal 
leging, mail, etc. When you conmect ta 128.6.4.7, you have ta epecify 
that you want to talk to the FTP server. This is done by having 
"Wwelil-knawn sockets" for each server. Recall that TCr uses port 
numbers to keep track of individual conversations. Liger pragrams 
normally use more or lees randam port numbers. However apecific part 
numbers are assiqned toa the programs that sit waiting for requests. 
For example, if you want to send a file, debe will getart & program 
calied "ftp". It will open a cannection using yme@ orancam mum 
ieoto tor the port number on its end. Wawel it will specify port 
number 21 for the other end. This is the official part number far the 
PYF server. Note that there are two different programs involved. You 
run ftp on your side. This is a proaram designed to accept cammands 
from your terminal and pass them an ta the other end. The program 
(he. you talk ta on the other machine is the FTF server. Bt) Uae 
desiqned to accept commands fram the network connection, rather thar 
an interactive terminal. There is no need for your program ta use a 
Well—known socket number for itself. Nobody is trying to tind it. 
However the servers have to have well-known mumbers, so that people 
e open coannectians toa them and start sending them commands. The 
G@rficial port numbers for each program are given in "Assigned 
Mumber se". 


ie 


, Bay 


Note that a connection is actually described by a set of 4 numbers: 
the Internet address at each end, and the TCP port nmumber at each end. 
Every datagram has all four of those numbers in it. (The Internet 
addresses are in the IF header, and the TCF port numbers are in the 
TCR header.) In order to keep things straight, no two cannections can 
have the same set of numbers. However it is enough far any one number 
to be ditferent. For example, ait is perfectly possible for two 
different users on a machine to be sending files ta the same other 
machine. This could result in connections with the following 
Parameters 


Internet. ee TCR ports 
Gomnection 1 126,.6.4.194, 126.604. 7 Lo ie 
mernection =) 126.6.4.194, 128. Si sa 


Since the same machines are involved, the Internet addresses are the 
SAME « Since they are both doing file transfers, one end of the 
conmmection invoelves the well-knewn port number far FTF. The only 
Sthing that differs is the port number for the pragram that the users 
Car@ running. That’s enough of a difference. Generally, at least one 
Pend of the connection asks the network software to assign it a port 
7 ber that if guaranteed ta be unique. Narmally, it’s the user's 
» Since the server has to use a well-known number. 
iS 
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Now that we know how to open cannections, let‘'s get back to the 
applications programs. As mentioned @arlier, ance TCE has opened a 
@egnnection, we have samething that might as well be a simple wire. 
{ the hard parts are handied by TCF and IF. However we still need 
60M@ jjagreament as to what we send over this connection. In effect 
this is simply an agreement on what set of commands the application 
Witte linderstand, and the format in which they are to be sent, 
Senerailly, what ig sent is a combination of commands and data. They 
Ug@ Context to differentiate. For example, the mail protocol works 
like this: Your mail program opens a connection ta the mail server at 
the other end. Your program gives it your machine’s name, the s 
of the message, and the recipients vou want it sent to. It then sends 
& Gammand saying that it is etarting the message. At that point, the 
ether end stops treating what it sees fLammands, and starts 
accepting the message. Yaur end then sending the taxth of the 
message. At the end af the message, a special mark is sent (a dok in 
the first column). After that, both ends understand that your program 
1G again sending cammands. This is the simplest way to do things, and 
the one that most applications use. 


eric ee 


Pile transfer is somewhat more complex, The file transfer protoacel 
involves two different cannections. It starts out just. like -mail. 


j 
The user's program sends commands like “log me in as this user", “here 
ig my password”, “send me the fil@ with this name". However once the 


command to send data is sent, a second connection i ting 
data itsel+. It would certainly be possible to send the data oon the 
game cannectian, as mail does. However file transfers often take a 
Lang time. The designers of the file transfer protocol wanted 
e Ow the user to icoantinue issuing cammands while the transfer is 
Ting on. For example, the user might make an inquiry, or he might 
abort the transfer, Thus the desiaqners felt it was best toa use a 
Separate connection for the data and leave the original command 
connection fer cammands. (It if also possibie to spen command 
connectians toa twa different computers, and tell them to send ai file 
fram ooane to the other. In that case, the data couldn't goa over the 
command cannectioan. ) / 


Remote terminal cannections use another mechanism still. For remake 
laging, there is just one commection. it nermaliy sends data. Wher 
it 16 necessary ta send a command (e.g. to set the terminal type or to 
change some mode), a enecial character is used to indicate that the 
next character is a command. If the user happens to type that epecial 
character as data, two of them are sent. 


We are not going to describe the application protocols in detail in 
this document. [t's better ta read the RFC’s yourself, However there 
are a cauple of common conventions used by applications that will be 
described here. First, the common network representations TCP/IF is 
intended to be ugable on any computer. Unfortunately, not all 
camputers agree aon how data is represented. There are differences in 
Deraracter codes «ASCII vse. EBCDIC), in end of (bine conventions 
- (carriage return, line feed, or a representation using counts), and in 
whether terminals expect characters ta be sent individually or a line 
o; a hime. In order to allow computers of different kinds toa 
MMAUNLCAaAbe , each applicatians proteacal defines & standard 
14 


Sle fy bi a) } fear Re 


4G? Aged, Jap &#.70l (ane keanom,! “OED | a Won) m 
beneqde aed SOT asne, ,erraae bein (nem ie nme 
> w DLOMLZ & Bo low 20 ni rath and” ete — 7 ini Ar 


mt ee@ MT raitssen woo eit aVvQ ‘ena on tA 2 b 
s5liimen SA wboaAmniias ) ay Fete 190) py oak eo 
45 45 eas, Bode ae Senn ety. bow we “ ie 


; tem Dos vo rmaneas: *0 reek dere t din io 6 a toee at 
ooo7e 4g titan ett ,olonere ago ate! tree +} tp ? 
av vee. [ream ery O82) eu toanneo BR BVO he WO “q ory "TLE 

: , BSS mrirnoen woOY was Fev io iS Oe og moy 

Aj [ oo 4ne@ da toe MOY ade teste eae bee g 


i ,toten eas apeveom oF Qatiieve ©). he! Pane, pe ty 
atz brie ,Rhilemmaay (26 ope ee Sarw Oita re . mt 
44 4 + @ris pong@ aejruatdea merkt Bie ~iiry O7a220M © OF 

s) thee o. onag Jelveqe £ \Rpeenen ety. 9a fae bedi 
Ps tf bistaehew ahem Aten, 2g 2 ‘5 i 
—epnia? ib aa Wi tro lamin eas #249 wirtt SO NAMHO sD ont 
OF kNGTISBDC1AGe FROM) 
ie 
jomand @1h? eff) ote DQmes waoA 9: AeAwingae a Bh: 
rer wInagpe ds} Sneak oeo0Nn0D inant i 
se ni wm Oot” as ED eoneemas abrwe a 00 
ey owe ‘amen «ind atiw @0F eid eno hege” © ee 
2 eo. 7 aor bncswe &-) tren ai Aagoh bran 
lk Hae. og idjeso@ oe yintesy eo luge oth. 
; eu” e414 av eect enh lism 2a 4 af 
9 View : 1 wiang i [c%®, ale to aoenp een 
iywt4 1) 2Orennhg ori loa ho Burris az 
4 yw ee A an gba. 4 i" “een ont , olan 
iw td iat 2 angie. wis wit] ae tee 
reno 3 acre a oi 7 Drie ret aris "OF not she 
mon re od 2 be vese Y 24. i +V3 r ehren nies 
er it if@? bem ,~@9etTuomps ane saat rey pas is 
O4 ‘ "lbluoo atletondd , eee Fath nl .sernto mee ee 
Cartvigs 
ep wi 
rome 9 " oe nares, Setloie sew anoigae won fa 1 
pues Linm yon IT oa, $oenno:> ene  Jewt ez 
Litres i) Soe OF .O-e) DrseAmnD & oes OF V4 
i mvt of beaw &@P 4eaoe fir fiaiosqe &° , tabem 4 
: av? oF eeodgent “a Ax +f .Onamna «- cS 
stfTae 238 mary. +o On? satan 
j or 
‘on mi alobealorqg aGrted tiie era ain Seee ot prt YY 


i+ syowohH -tilaz4ist® 1° Da er > Geen oF rend tact 2° eat 
tw Jett evnolitantiags, va heer ang tensvnos SRUNMC OD " 
ag. sro tes3o nese eee weenie? a Mommas st » diel 
fie Pore eh fevorndgao Wa Ae tuo: a ser PP pe ries 
panenettib ava wyertl Haines 
rat trtevros ans *@ Liiva FO 9g 4 i 
H Of, tai rii90% pinta nO. I Ne NIAH DM wx 
oni & 70 ytieub iy tht rei ies rds 
n° mekrey Ba ne 94s) 86) Re TeQmeD 
inbra te % 2ernieeah Lene A 


i ‘ane 
ti ivan, 


representatian. nore  thak TCP sand Gir dae not care about, the 
Peepresentation. TCeE simply sends octets. However the programs at 
i Pees tare TG agree cn Now the octete are to he interpreted. The 
ee CUfor[6CUeaCKCUappLacatbion 6 6 specities the standard representatian far 
That application. Normally it ais “net ASCII”. This uses ASCITT 
tharacters, with end af line denoted by a eecr return followed by 
& line feed. Far remote lagin, there is als a definition of a 
“standard terminal’, which turns aut to be a Hed #6 ‘Guplex terminal with 
echoing Happening on the local machine. Most applications alsa make 
provigions for the two computers to agree an other representations 
that they may find mare canvenient. Far example, FPOFR-i@’a have eee bit 
words. There i168 & way that two FOP-1@’s can aqree to send a 
Ginary file, Similarly, two systems that prefer fulleduplex ccewtn 
conversations can agree an that. However each applicatian has a 
standard representatian, which every machine must suppart. 


3.1 An example application: SMTP 


In order to give a bit better idea what is invelved in the application 
protocale, {'m going to show an example of SMTF, which is the mail 
protocel. (SMTF is “simple mail transfer protocol.) We assume that a 


computer called TOPAZ.RUTGERS. EDU wants ta send the tollowing message. 


Ponce sat, ey Cun ay LS peer Sl) EDT 
Fram: hedrick@toapaz.rutgers., edu 
im: levyGred.rutgers., edu 

Subjects meeting 


bets get together Monday at ipm. 
Patees Nate that format of the message iteelf is described by an 
Internet standard Gee). The standard Maan a the fact that the 
Menage mush be transmitted as net ASCII ti.e. it must be ASCII, with 
tearriage ceturn/linefeed toe delimit Lines). it also describes the 
general structure, as a group of header lines, then a blank line, and 
then the body of the message. Finally, it describes the syntax of the 
header lines in detail. Generally they consist of a keyword and then 
a value. 


Mote that ee acddregage is indicated As LEVY@REDORUTGERS. RDU. 
Initially, addresses were simply “person at machine”. However recent 
gtandards have eae things more flexible. There are now provisions 
for systems to handle other systems’ mail. This can allow automatic 
forwarding on behalf of camputers nat connected ta the Internet. Tt 
ai be used to direct mail for & number of systems to one central mail 
server. indeed there ig no requirement that an actual camputer by the 
name of RED. RUTGERS. EDU even @xist. The name servers could be set up 
$0 that you mail to department names, and each department's mail is 
routed automatically to an appropriate camputer. lt if also possibie 
‘that the part before the @ is something other than a user name. os 
Pesaible for pragrams to be set up to process mail. There are aise 
favyisions to handle mailing liste, and generic names such as 
. : 15 
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coe way ithe message if to be gent to another gystem ie described by 
ic} ‘Ss S2l and 74. The program that i868 going ta be doing the sending 
asks the name server several queries ta determine where toa route the 
| MeSSage. The first query is ta find gut which machines handle mail 
pror the name RED. RUTGERS.EDU, In thig case, the server replies that 
Pee. RUTGERS. EDU bard les its own mail. The program then asks far the 
‘@ddreges of RED. RUTGERS which is Pas Then the mail prog am 
apens a TCR connection to. shoe oe cts Po. be He Port ade tie 
well-known socket used far Ley ede Qnce this conr 
Pestablished, the mail program starts sending commands. a 
typical conversation. Each line i8 lahelled as to whether it is fram 
TOPAZ ar RED. Note that TOPAZ initiated the connections 


RED e2oere DD Ke SERS EO Satire service at) 29 dunmei? OS1l72i8 EDT 
TOPAZ HELO toamnarz.rutdqers. edu 

RED ace RED«RUTGERSs«ERUsenhed to, TOPAZ. RUTGERS.EDU 
TOPAZ MATL Feroms<hedrick@tapaz.rutgers. edu> 

PED) ew MATL accepted 

TOPAZ RCET Tostlevy@red.rutgqers. edus 

RED ead Kecioienk accepted 

TORFAZ DATA 

RED oot Start mail inpuhks end with <CRLF?. CRLF > 
Pteas spate: Sab, 27 dune? 1S92625) EDT 

TORAE Frams hedreick@topaz.rutgers. edu 

TOPAZ To: levy@recd.rutgers. edu 

TORAZ Subjects meehing 


i @ TOF AZ 
TOPAZ Let’s get together Monday at lpm. 
TEPAZ . 


RED at (iE 
TOPAZ GUILT 
RED eel RED,RUTGERS.EDLU Service clasing transmiesi 


om channel 


Pirst, note that commands all use normal text... This i6 ipo 
(Internet standards. Many of the protocols use standard I 
commands. This makes it eagy toa watch what is going on and to 

diagnose problems. For example, the mail program keeps a log of each 

canversatiori. if samnething goes weang, the loq file can simply he 

Pentee tO the postmaster. Since it is normal text, he can see what 

Was going oan. It alsa ismmebsiohe a tivaer ce Griteract! direct? with’) the 
‘mail server, for Lt « (Some newer orotacals are camplex enaugh 

that this is not ueespoyary arth The commands would have to have a syntax 

(that would require a significant parser. Thus there is a tendency far 
“newer protocols to use binary formats. Generally they are structured 
eee OF Pascal record structures.y ‘Second, note that the responses 
‘all begin with numbers. This is alsa typical of Internet protocols. 
[The allowable responses are defined in the protoceal. The numbers 
allow the user program to respond unambiquously. The rest of the 
Weeponse is text, which is normally for use by any human who may be 
Watching or looking at a log. Tt has no effect an the operation af 
the Prac ans « (However there is one point at which the protocel uses 
toof the text of the response.) The commands themselves simpiy 
owe the mail program on Gane end to tell the mail server the 
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informatian it needs to know in order to deliver the message. In this 
Gase, the mail server could get the information by locking at the 
( itself. Eut for more complex cages, that would not be sate. 
q ry seggion must beqin with a .J, which gives the name of the 
system that initiated the connection. Then the sender arid 

are specified. ‘There can be more than one RCFT command, if the 
several recipients.) Finally the data itself is sent. Novetthar the 
text of the message is terminated by a line containing just a period. 
(If such a line appears in the me a, the period is doubled.) After 
the message is accepted, the sender ran send another messacqe 
terminate the session ac in the example above. 


Generally, there is a pattern to the responge numbers. The protocal 
defines the specific set of responses that can be sant = 
any given command. However pragrams that dan’t want toa 
Me Geta i can just “look at the first cigit. In general SCH 
that begin with a 2 indicate Success. Those that begin with 2 
indicate that some further action is needed, as shown above, 4 and & 
indicate errors. 4 ig a “temporary” errar, such as a disk filling. 
The message should be BaAverdl y and tried again later. 3 is a permanent 
error, such as a non-existent recipient. The message should be 
returned ta the sender with an error me ; 


= 


‘For more details about the co mentioned im this 
Reo = B21/78e2 for mail, RFG 989 for file transfer, and 
for remote logins. Far the ier Skene port numbers, 
edition of Assiqned Numbers, and possibly RFC 814.) 


4. Protocols other than TCR: UDF and ICMF 


So far, we have described only cannections that use TCR. Recadl.. hat 
TCP is responsible for breaking’ up messages into datagrams, and 
reassembling them praperly. However im many applicathians, we have 
messages that will always fit in a single datagram, Am @xanple 16 
name lookup. When a user attempts to make a connectian toa another 
system, he will generally specify the system by meme, rather than 
internet address. His system has ta translate that name ta an ricci 
before it can do anything. Generally, only a few systems have 
database used to translate names to addresses, Soa the te 
Will want to send a query to one of the systems that has datamase. 

This guery is going to be very short. i pe toceeiai rile @ fats AN Gane 
datagram. Sq will the answer. Thus it seems silly to use TCR. Of 
course TCE does more than just break things up into datagrams. Pe 
aleo makes sure that the data arrives, resending datagrams where 
necessary. But for a question that fits in 4@ single datagram, we 
Hone need all the complexity of TCP to do this. if we don’t get an 
answer after a few seconds, we cam just ask again. Far applications 
like this, there are alternatives to TCF, 


z 


The most common alternative is UDP ("user datagram protocol"). UDF is 
esiqned far applications where you dan’t need to put. sequences of 
Wtagrams together. tt 4its into the system much like TCP. There is 
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a UDF header. The network software pute the UDF header on the front 

f your data, just as it would put a TCE header on the front of your 
@eta. Them UDF sends the data ta i aIF, which adde the j IF header, 
putting UDF’s protocol mumber in the protecol field instead of TCR‘ « 
 protecol number. However UDF doesn't do as much as TCR does, Bet 
doesn’t split data into multipie datagrams. [It doesn’t keep track of 
Swhet it-has sent so it can resend if necessary.  Aboub all that UDF 
“frovides is port mimbers, ea that several programs can use UDF at 

onee. UDF pork mumbers are used just dike TCrP port numbers. Tree e 
Sere well-known port numbers for servers that use UDF. Note that the 
UDF header is shorter than a TCF header. Ti still has source and 
destination port numbers, and a checksum, but that’s about it. Ne 
Sequence number, since it is mot needed. UDF is used by the protoce 
that handle name lookups (see TEN illo, RFC oe and UFC Sens) 
number of similar proatocale., 
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and 


Another alternative protocol is ICMP ("Internet cantrol a 
Bimemoml 3 . ICMP 2S used for errar messages, and other messages 
intended far the TCR/IF software itself, rather than any particular 
USer program. For example, if you attempt to camnect to a host, your 
Syatem may get back an ICMF meseage saving “host unreachable", LCMF 
Gan also be used to find out same inftarmation about the network. See 
Peete for details of [CMF. ii Ae beta ters to: WOE, intiethath. it 
handies measages that fit in one datagram. However it is @ven fimpier 
than UDF. It doesn’t even have port numbers in its header. Since all 
{CMF messages are interpreted by the network software ite@lf, no port 
numbers are needed to say where a ICM messac iS Supposed ta qo. 


ry 


wv. Keeping track of names and informations the doamain system 


AS we indicated earlier, the network software generally 3 & 
Internet address in order ta Open a connectian ar send a datagram. 
However userae prefer to deal with computer names rather than nmumberse., 
Thus there if a database that allows the safiware to book up a name 
and find the corresponding number. When the Internet was small, this 
WAS @agy. Each system wouid have a file that listed all af the other 
syctame, giving beth their name and number. There are mow toa many 
computers for this approach to be practical. 2 files have 
been renlaced by a set of name servers that keep hosh nanes 
and the corresponding Internet addresses. (In fact these servers 
somewhat more general than that, This if just one kind information 
stored in the domain system.) Noke that a set of interlocking servers 
Dare used, rather than a single central one. There are now 60 many 
Piifterent institutions connected. to the Internet that it would be 
impractical for them to notify a central authearity whenever they 
installed or moved a computer. Thus naming authority is delegated ta 
individual institutions. The name servers form a tree, rorrespoandi ng 
Meee institutional structure. The mames themselves follaw a similar 
Metructure. A typical example is the name BORAX.LCS.MIT.EDU. This is 
computer at the Laboratory for Computer Science (LCS) at MIT. in 
to find its Internet address, you might potentially have to 


consult 4 different servers. First, you would ask a central server 
1g 
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fcalled the root) where the EDU server is. EDU is a server that keeps 


‘track of educational institutions. The root server would give you the 


(The domain system is not limited to finding out Internet 


7 and Internet addresses of several servers for EDU. (There are 


@ral servers at each level, to allow for the poseibly that one 
might be down.) You would then ask EDU where the server for MIT is. 
Again, it would give you names and Internet addre 3 of several 
servers for MIT. Generally, mot all of those servers would be at MIT, 
to allow for the possibility of a general power failure at MIT. Then 
you would ask MIT where the server for LCS is, and finally you would 
ask one of the LCS servers about BORAX. The final result would be the 
Internet address for BORAX.LCS.MIT.EDU., Each of these levels 1 
referred to as a "domain". The entire name, BORAX.LCS.MIT.EDU, is 
called a "domain name”. (So are the names of the higher-level 
@amains, such as LCS.MIT.EDU, MIT.EDU, and EDU.) 


Fortunately, you don’t really have to go through ali of, this most of 
the time. First of all, the root name servers also happen to be the 
name servers for the top-level domains such as EDU, Thus a single 
query to a root server will get you bee elit. Secand, sartware 
generally remembers answers that it got before. So once we look up a 
name at LOS.MIT. EDU, our software remembers where ta find servers $ or 
Besei?. EDU, MIT.EDU, and EDU. lt also remembers the translation of 
BORAX.LCS.MIT.EDU. Each of these pieces of information hae a “time to 
live" associated with it. Typically this is a few days. After that, 
the information expires and has to be looked up ACAL TM. This allows 
imsetitutions ta change things. 


addresses, 


eo: domain name is a node in a database. The node cam have recards 
= Be 


r 
® 


st define a number of different properties. Examples are Internet 
address, computer type, and a list of gervices provided by a computer. 
A orogramn can ask for a specific piece of information, or all 
information about a given name. leas possible: for a ‘node in, the 
database to be marked as an "alias" (Cor nickname) for another noce 
tt is also possible to use the domain system toa store information 


about users, mailing lists, or other objects. 


There is an Internet standard defining the operation of these 
databases, aS well as the protocols used ta maak ge ; af them. 
Every network utility has to be able to Make such gince this 
is now the official way to evaluate host names. Generally utilities 
will talk to a server on their own system, This server will take care 
of contacting the other servers far them. This keeps down the  ameaunt 
of code that has to be in each application pragram. 


The domain system is particularly important for handling computer 
mail. There are entry types to define what computer handles mail far 
a given name, ta specify where an individual is to receive mail, and 


to define mailing lists 


(See RFC’s 802, 883, and 973 for specifications of the damain system. 


REC 974 defines the use of the domain system in sending marl. 
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eo pravide better performance or reliability than general-purpose 


6. Routing 


Ah & description above indicated that the IF implementation is 
(beget for getting datagrams to the destination indicated by the 
degtination address, but little was said about how this would be dane. 
Mieweaesh of finding how to get) a datagram to its destination is 
Pere red to as “routing”. In fact many of the detaile depend upon the 
Particular implementation. However some general things can be said. 


Firet, it is necegsary to understand the model on which IF is aged 


IP assumes that a system is attached to some local network. We ASSUME 
That the system can send datagrams to any other system oan its own 
network . (In the case of Ethernet, it simply finds the Ethernet 
address of the destination system, and pute the datagram out oan the 
Ethernet.) The problem cames when a system is asked to send a 
datagram to a system on a different network, THis problem is handled 
by Gateways. A gateway 16 a system that connects a network with one 
or more other networks. Gateways are often normal canputers that 
happen to have more than one network interface. For example, we have 
@ Unix machine that has two different Ethernet interfaces. Thus it is 
connected toa networks 129.46.4 and 128.6.3. This machine can act as a 
Gateway between thase two networks. The software on that machine must 
be set up s0 that it will forward datagrams from one network to the 
other. That is, if a machine on network 126.6.4 sends a datagram toa 
the gateway, and the datagram is addressed to a machine on network 
LeG.6.5, the gateway will forward the datagram to the destination, 
Major communications centers often have gateways that connect a number 
of different networks. (In Many Cases, special~purpose gatew 


mit 


Wetems acting as gateways. A number of vendors sell such systems. } 


=n 


Routing in IP is based entirely upon the network number of the 
destination address, Each camputer hag a table of network numbers. 
For each network number, a gateway is listed. This is the gateway ta 
Be used to get to that network. Note that the gateway cdoean 't to 
cannect directly to the network. It just has to be the best 
go to get there. For example at Rutgers, our interface Senet is 
at the John von Neuman Supercomputer Center GIvNC). Gur conmmection to 
dvMC iS via a high-speed serial line cannected to a gateway 
Sees ts L2G.6.5.12. Systems on net 1268.46.35 will list 126.4.3.12 
the gateway for many off-campus networks. However Yete Gn 
128.664 will list 1268.6.4.1 as the gateway ta those same Off-campus 
networks, LeG.G.4.1 a6 the gateway between networks 128,4.4 and 
$28.6.5, $0 it is the first step in getting ta JvNc. 


When a computer wants to send a datagram, it first checks to see if 


— 


the destination address is on the system's own local network, if go, 
the datagram can be sent directly. Otherwise, the expects ta 
find an entry for the network that the destination is an. The 
datagram is sent to the gateway listed in that entry. This table can 
get quite big. Far example, the Internet now includes several hundred 


“individual networks. Thus various strategies have been developed to 


peeuce the size of the routing table. One strateqy is to depend upon 


i 
mefaruit routes". Often, there ig only one gateway out of a network. 
eo ad 
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This gateway might connect a local Ethernet to a campus-wide backbone 
ayer: In that case, we don’t need to have «a separate entry for 

ery network in the world. We simply define that gateway as a 

Fault". When no specific route is found for a datagram, the 
Reece am is sent to the default pak Se A default gateway can even 
be used when there are several qateway on a network. There are 
PrOViGions for gateways to send a ese aye saying "I'm not the b 
Gateway -~ wse this ane instead." (The message is sent via ICMF. 
BFC 795.) Most network software is designed to use these me 
add entries to their routing tables. . Suppose network 126.46.4 has two 
PecetavSs, 12h.6.4,59 and 128.46.4.1. 126.6.4,. 55 


Se 


qee to 


fate dan 26.6.4. 59 leads to several other 
internal Rutgers networks. i28.6.4.1 leads indirectiy to the NSFret., 


SUPPOSe we set 128.6.4.59 as a default gateway, and have no other 
Fouting table entries. Now what happens when we need to send a 
datagram to MIT’? MIT a6 network 18. Since we have mo entry far 


network ih, the datagram will be sent to the default, i2¢ 


Pai. ee de £353 
it happens, this gateway is the wrong one. Go it will forward the 
Gatagram to 1268.6.4.1. But it will also send back an @rrar saying in 
effect: "to get to network 18, use 126.6.4.1", Our software will then 
acid am entry ta the are table, Any future datagrams ta MIT will 
then go directly 3 (The errar message ode. sent using the 
cr pretacol. The ig called "ICMP redirect.) 


Most TF experts recammend that individual computers should not tore) | Ae 
keep track of the entire network. Ingetead, they should start with 
detault gateways, and let the gateways tell them the routes, as just 


described. However this doean't gay how the gateways should find cut 
Pabout the routes. The gateways can’t depend upon this etreratedy.« They 


written as 4 octets (in dec 
he) ditferent types of address. The problem is that the address has toa 


Bye to have fairly complete routing tables. For this, some sort of 

uting proaotecoal is needed. A routing protoceal is simply a technique 
fOr the gateways to find each other, and keep up to date about the 
beat way to get to every network. REC (I@@9 contains a review of 
Gateway desiqn and routing. However rip.doc is probably a better 
introduction to the subject. It contains some tutorial material, and 
a detailed description of the most commonly-used routing protocel, 


7. Details about Internet addresses: subnets and broadcasting 


AS indicated earlier, Internet addresses are Si-bit numbers, normally 
imal), @.6g. 128.6.4.7. There are actually 


indicate both the network and the host within the network. it WAS 


Felt that eventually there would be lots of networks. Many of them 
“Would be small, but probably #24 bits would be needed to repre 


amt ad 
the TF networks. It was also felt that some very biq networks midht 


feed 24 bits to represent all of their hosts. This would seem to lead 
to 46 bit address 


ses. Eut the designers really wanted to use Se bit 
addresses. So they adopted a kludge. The assumption is that most of 
The networks will be small. So they set up three different ranges of 
Gdress. Addresses beqinning with 1 to 126 use only the first octet 
at 6 the network number. The other three octets are available for the 
st number. Thus 24 bite are available for hosts. These numbers are 
rp 8 
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“used for large networks. But there can only be 126 of these very big 
“Hetworks. The Arpanet is one, and there are a few large commercial 
—mtworks. But few normal organizations get one of these "clases A" 
POR isos. For normal large organizations, "class 6" addresses are 
“Weed. Class 8 addresses use velba first two octets far the network 
number. Thus network numbers are bothered el. 254. (We avo 
and 255, for reasgane that we see below. We aleo avoid addr 
Beginning with 127, because that is used by some systems for special 
Purposes. ) The last two actets are available far host adda: 
@iving 16 bits of host address. This allows for 642156 computers, 
which should be enough for most orqanizations. (It 18 poe ible toa 
mare than ane class B address, if you run aut.) Finally, 
addresses use three octets, in the range 192.1.4 to Ais 
These allow anily S254 hosts oan each network, but there can be z 
these  metworks. Addr@aged eahave 22. are reserved for future use, as 
Class Dand E (which are currently mot defined). 


Many large arganizations find it convenient to cdivide their network 
number into "subnmete’. For example, Mutgqers has been agsiqned a class 
Roaddress, 128.6. We find it convenient toa use the third octet of the 
addreas to indicate which Ethernet a host ig on. This division has no 
Significance outside of Rutgers. A computer at another institution 
would treat all datagrams addressed toa 128.46 the game way. They wenalad 
mot took at the third oetet of the address. Thus camputers oautes 
Rutgers would not have different routes for 126.6.4 or 126.6,.5. 
ingide Rutgers, we treat 12n.6.4 and 129.6.5 as separate networks. in 
effect, gateways inside Rutgers have separate entries far each Rutgers 
Subnet, whereas gateways autside Rutgers just have ane entry far 
@. 6 Wote that we could do exactiy the same thing by using a 

Parate class C address for each Ethernet. As far as Rubtqers is 
Concerned, it would be just as convenient for us to have a number of 
class C addresses. However using clase C addresses would make things 
inconvenient far Lhe rest at the world. Every institution that 2] 


wart ¢ 
toa talk to us would have to have a separate entry for each one of aur 
networks. [If every imstitution did this, there would be far too many 
networks for any reagonable gateway to keep track of. Ey subdividing 
&@ clase B network, we hide aur internal structure from everyane , 
and gave them trouble. This eubnet etrategy requires enecial 
OrOVisions in the network software. It is described ri eis ee 


@ and 255 have special meanings. @ is reserved for machines that 
den’t know their addrese. In certain circumstances it is possible far 
a machine not te know the number of the network it is on, or even its 
Gwn host address. Far example, @.@.8.25 would be a machine that knew 


Gt was host number 23, but didn’t know on what network. 


edd i8 used for "broadcast". A broadcast is a message that you want 
€@very gyetem on the network to see. Broadcasts are used in some 
Situations where you dan’t know whe to talk to. For @xample, suppose 
you need to look up a host name and get its Internet address 
Sometimes you dan’t know the address of the nearest mame server, in 
that case, you might send the request ag a broadcast. There are alsa 
fases where a number of systems are interested in information, Le oe 
en less expensive ta send a single broadcast than ta send datagrams 
ividualily toa each host that is interested in the information. in 
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order to send a broadcast, you use an address that is made by using 
T network  addreas, with all ones in the part of the wih eer & 
sf 


: mst mumber goes. For example, if you are on network 12e.6.4, you 
~ would use 126.6.4,255 far broadcasts. How thig is actually 
“implemented depends upan the medium. Tt ais not possible toa send 

broadcasts on the Arpanet, or on point to point lines However ih is 
| possible on an Ethernet. [Tf you use an Ethernet addr with ald tts 
Bits on (all ones), @very machine on the Ethernet is supposed ta loak 
> at that datagram. 


Although the official broadcast address far nmehwark 128.6.4 i6 now 
128.6.4.255, there are some other addresses that may be treated as 
broadcasts by certain implementatiangs., For convenience, the ehandard 
@iso .silows: 253.255.255.255 to be used. This refers ta riba hashes an 
the local network. It is often eT ea LO USe 205. 255... : eae wd 
of finding out the network number far the local network and forming & 
broadcast address such as 126.46.4, 255, In addition, certain 3] 
implementations may use @ instead of 255 form the broadcast 
address. Such impleamentatians eee wee Lee 1.@ instead ct 
128.6.4.255 as the broadcast address on network ikS.6.4. Final 
certain older impleamentatians may not wider stand about subnets. 2 
they consider the network number ta be 12c.6. in that case, they will 
assume a broadcast address of 128.46,.255.255 ar 128.6... Until 
Support for broadcasts is implemented praperly, it 
dangerous feature to use. 


Zi 


can be a samewhat 


Because @ and SSS are used for unknawn and broadcast 
sts )6Co should never be given addresses cantaining @ or 
Guld never begin with @, i127, or any number above #2. 3 

Violating these rules are sametimes referred ta as ae ae Dec ause 

ef rumors that the Central University of Mars is using network i hon 


iis 


8. Datagram fragmentatian and reassembly 


TCP/IP is designed for use with many different kinds of network. 
Ainfortunately, network designers doa not agree about how big packets 
can be. Ethernet packets can be 1304 octets Lond. Arpanet packets 
have a maximum of around 1844 octets. Same very fast networks have 
mach Larger packet sizes. At first, you might.think that jr should 
Simply settle oan the emallest possible size. Unfortunately, this 
would cause serious performance problems. When transferring : 
files, big packets are far more efficient than small ones. So we want 
to be able to use the largest packet size possible. But we alsa want 
to be able to handle networks with small limits. There are two 
Provisions for this. First, TCF has the ability to “negotiate” abaut 
datagram size. When a TCE connection first opens, both ends can send 
the maximum datagram size they can handle. The smaller of es 
mee oer= is used far the rest of the connection, This allows two 


©implementations that can handle big datagrams to use them, but alsa 

ts them talk to implementations that can’t handle them. However 
@ 6 doesn’t completely salve the problem. The mast serious problem 
that the two ends don’t necessarily know about all of the sheps in 


aol 


between. For example, when sending data between Rutgers and Berkeley, 
it is likely that both computers will be an Ethernets. Thus they wild 
[ be prepared to handie IS8@-octet datagrams, However the 
Pinection will at some point end up going aver the Arpanet. fy Can’t 
Randle packets af thah size. For this reason, there are provisians 
eplit datagrams aes) inte pieces. (Thig if referred toa i 
*tragmentation”".) The IF header contains fields aimdicating the a 
datagram has been split, and enough information to let the pier 


2 


put back together. [If a gateway connects an Ethernet toa the Arpanet, 


it must be prepared to take IS@@-octet Ethernet packets and split them 
into pieces that will fit an the Arpanet. Pau thermore , every bch 


implementation af TCRSTIF must be prepared to accept pieces and put 
them back together. This if referred to as "“reasnembiy'. 


TCRP/IF implementations differ in the aporoach they take to deciding an 
datagram Size. ft i686 fairly comman for implementations ta “ 
efov~hyte datagrams whenever they can’t verify that the entire path is 
able to handle larger packets. This rather conservative etraheqy is 
used because of the number of Se ates 2 OBS with bugs in the code to 
reassemble fragments. Implementors often try to avoid ever having 
fragmentation occur. Different implementors take different approaches 
to deciding when it is safe to use large datagrams, Some use them 
oniy for the local network. Others will use them for any network on 
the Ame CNL o76& bytes is a "safe" Size, whith every 
implementation must support. 


® Ethernet encapgulatians ARF 


There was a brief discussion @arlier about what [FP datagrams lank like 
am oan Ethernet. The cdiscussian showed the ethernet header and 
Shephawm. However it left one hole: It didn’t say how to figure out 
what Ethernet address to use when you want ta halk to 4a given Tnternet 
addr eae. Im fact, there is a separate protocel far this, called ARF 
(address resolutican proatacal”’)., (Nate by the way that ARF as not an 


hs 
iP pretecel. That is, the ARF datagrams do not have IF headers.) 
Suppese yau are on system 126.6.4,.194 and you want to connect ta 
system 126.6.4.7. Your system will first verify that 1258.6.4.7 16 oan 
the same network, $0 it can talk directly via Ethernet. Then it will 
Pee ede. fet. Sin its BRP teble, ta,see af ait, already knows the 
Ethernet acddregea. ae 6, it will stick on an Ethernet header, and 
gend the packet. But suppose this system is mot ain the ARF table. 


a 


There is mo way to send the packet, because you need the Ethernet 


address. Soit uses the ARF protacol to send an ARF request. 
iye, eck oem an ARF request says "i need the Ethernet address for 
1278.6.4.7 » Every system listens to ARF requests. When a system sees 
an #RFP request for itself, it is required to respond. soa ft ? 
Will see the request, and will respond with an ARF reply Saying in 
Street “1260.6.4.7 1% Ge 26:125691 54", (Recall that Ethernet addresses 


are 46 hits. This is 6 octets. Ethernet addresses are canventionally 


ots in, € 13 aw a a 


‘shown in hex, using the punctuation shown.) Your gystem will save 


oe es 


Z ig information in its ARF table, so future packets will goa directly. 
@e@ 


t systems treat the ORF table ag a cache, and clear entries im ait 
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if they have not been used in a certain periad af time. 


Bete by the way that ARF requests must be sent as "broadcasts". There 
a) mo way that an ARF request can be sent directly ta the right 
System. After all, the whole reasan for sending an ARF request is 
that you don’t know the Ethernet address, So an Ethernet address of 
Sli Ones is used, i.es Fffeffeffaeffeffeft, Ry canventiaon, every 
machine .on the Ethernet is required to pay attention to packets with 
this as an address. SOQ every system seeg every ARF requests. They 


all dook to see whether the request is for their own address. [ft 86, 


they respond. if not, they: could gust ignore it. (Same hagts will 
use ARF requests to update their knowledge about other hosts on the 
network, even if the request ien’t for them.) Note that packets 386 
Te address indicates broadcast (e.g. 258.255.255.255 or i29.6.4. 255) 
are@ aleo gent with an Ethernet addres that is all ones. 


i@. Getting more information 


This directory contains documents describing the major protocols. 
There are literally hundreds of documents, so we have chosen the ones 
that seem most important. Internet standards are called RFC ‘s, rr 
Stands for Request for Comment. A prapased standard is initially 
issued as a proposal, and given an RPC miu er . When it ig finally 
pecerrecgy it is added to Official internet Protocols, but it’is still 
referred to by the RFC number. We have also included two T€ 

PMs used to he «a& separate classification for more informal 

cuments. This classification no longer exists ~- RFC’s are now used 
ter eli official Internet documents, and a mailing list is us ; for 
more informal reports.) The canvention ig that whenever an RFC 
revised, the revised version gets a new number. This is fine for nee 
purposes, but it causes problems with two documents: Assigned Numbers 
and Gfficial Internet Freoatocolis., These documents are being revised 
all the time, so the RFC number keeps changing. You will have to laok 
in Pee tide: ctxt to find the number of the latest edition. Anvone who 
iS Seriously interested in TCF/IF should read the RFC deseribing IF 
Cf Ps RF 1489 is alsa useful. It 16 & Specification for gateways 
To be used by NSFnet. As such, it cantaings an overview of ai lot of 
the fTCF/TIP technology. You should probably also read 
Of at least one of the application protocols, just to ge 
the way things work. Mail is probably a goad one (821/78: Le oe 
(79S) 16 of course a very basic specification. However the  ¢ is 
tairly complex, 80 you should anly read this when you have the time 
and patience ta nee ok about it carefully. Fortunately, the author of 
the major RFC’ s (Jon Postel) is a very good writer. The TCF RFC is 
far @agier toa rese than you would expect, given the complexity of what 
it i168 describing. You cam look at the other RFC’s as you became 
curious about their subject matter. 
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or 


Here is a list of the documents you are more likely to wants 


P+te-index list of all RFC'’s 
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Len-4&8 


somewhat fuller List of all FFE’ s 


Official Protocols. It's useful to scan this to see 
what tasks protocols have been built for. This defines 
which RFCO’s are actual standards, as opposed to 
requests far camnents. 


Assigned Numbers. If you are working with TCP/IP, you 
Will probably want a hardcapy of this as a reference. 
It’s not very exciting to read. It Lists ali the 
affically defined well-known ports and lots of other 
things. 


NSeFnet gateway apecifications. A good overviaw of IF 
routing and gateway technology. 


netkkilOS: networking far FC's 

update an domains 

FTF (file transfer) 

subnets 

FOPS2 protocol for reading mails an/FPC’s 

how IF is to be put on Ethernet, see alsa rfc8es 
domains (the database used ta goa from host names ta 
Internet address and back ~~ alsa used to handle UUCF 
these days). See also rfc¥7s 

telnet ~- protocel for remote logins 

ARF = protaceal for finding out Ethernet addresses 

mail 


names and ports ~- general concepts behind well-known 
parts 
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gphileasaphy behind TCr/TF 

= follawing dacuments are samewhat more epecialized. 
Ct oa = window and acknowledgement strategies in TCr 
per res 1 datagram reassembly techni ques 
Sreagls fault isolation and regsolutian techni ques 
ras 1 7 modularity and @fficiency in implementatian 
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Premier ~dod, 904,975,985 
EGE and related issues 


To these of you who may be reading this document remotely instead of 
at Rutgers: The most important FRFC’s have been collected into a 
three-volume set, the DON Frotocal Handbook. It is available fram the 
DDN Wetwork Information Center, SRI International Raven gwocc 
Avenue, Meniao Fark, California 9G4@25 (telephone: 888-2A5—-3155)., Yous 
should ibe able to get them via anonymous FTF from Gri-nic, arpa. rade 
Names ares 


REC oss 
i) rfosrforindex.tet 
ST efourfoxxn. tet 
TEN ss 


iensienc-index.tet 
Lenrvienm-xxx. txt 


Fip.doc is available by anonymous FTF from topaz.crutgers.edu, ag 
peer top -ip-doce/rip.doc. 


Sites with access to UWICF but mot FTP may be able to retreive them via 
UUCr from UUCF host rutgers. The file names would be 


RC Ss 
ftopaz /pub/pub/tcp-ip-doce/rfcwindex. txt 


TEN’ ss 
/topaz /pub/pub/tcp-ip-daocse/ienv-index.txt 
*/topeadc/pub/pub/tcp-ip-dacs/ien-xxx. txt 
ftopaz/pub/pub/tep-ip-doce/rip.dac 


Note that SRI-NIC has the entire set af RFC’s and TEN’s, but rutgers 
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Datastorm Technologies, Inc. was previously known as FIL Software 


Systems. 


This manual was completely updated to reflect the current state of the 


program as of release 2.4. 


Specifications subject to change without notice. 


FroComm (TM) software copyright (C) 19835, 1986 Datastorm Technologies, 


Inc. All rights reserved. 


This document copyright (C) 1986 Datastorm Technologies, 
reserved. 


FroComm is a trademark of Datastorm Technologies, Inc. 


LNG All rights 


Most of the hardware names in this manual are trademarks or trade names 


of specific manufacturers. 


Frinted in the United States of America 


~AT9 28 nwonded yievoivese. ee@w «aii ,aeioo lunnaet | 
hap 


n1wteaded saeT seeer (3) wv "Os tv 'aQe ash tie 


aio ens 25aitat oF sidptabe Lily isi abaoale 2aw 


.* 5 cead [ea i et 


.20iton Juonstiw apgnada OY toet da te 


‘Bey (98a eat 
OfondiseT Mtwsested SIL (O) idpiayada 


= y 


tee, t 
onl » es leo lerfzal mwmde464sted 45 i etebaae 
vy ’ » 
2Axyshesbe ny ate deéuias eid ni @emen seni 


: PY 
oe 2S ~wwI28 ¢. fi ik 


7 - 
a] ar, 


Boi 7eme ta. sates -bod teu 
A) ; Pi 


i 


FroComm 3. 4 License 


LICENSE 


oy 


All versions of FroComm, including version 2.4, are not public domain 
software, nor are they free software. 


FroComm is copyright (C) 1985, 1986 by Datastorm Technologies, Inc.. 


Non-registered users are granted a limited license to use FroComm on a 
trial basis for the purpose of determining whether FroComm is suitable 
for their needs. Use of FroComm, except for this limited purpose, 
requires registration. Use of non-registered copies of ProComm by any 
person, business, corporation, governmental agency or other entity 
institution is strictly forbidden. 


Registration permits a user the license to use FroComm only on a single 
computer; a registered user may use the program on a different computer, 
but may not use the program on more than one computer at the same time. 


No user may modify FroComm in any way, including but not limited to 
decompiling, disassembling or otherwise reverse engineering the program. 


All users are granted a limited license to copy FProComm only for the 
trial use of others subject to the above limitations, and also the 
followings 


FraComm must be copied in unmodified form, complete with the file 
containing this license information. 


The full FProComm documentation must be included with the copy. 


No fee, charge or other compensation may be accepted or requested 
by any licensee. 


FroComm may not be distributed in conjunction with any other 
product. 


Operators of electronic bulletin board systems (Sysops) may post FProComm 
for downloading by their users only as long as the above conditions are 
met. 


Distributors of public domain or user supported software may distribute 
copies of ProComm subject to the above conditions only after obtaining 
weitten permission from Datastorm Technologies, Inc.. Such permission 
usually is granted; please write for details. 


See the Ordering section for more information on registration, corporate 
licensing and similar topics. 
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Frolomm 2.4 Warranty 


WARRANTY 


Datastorm Technologies, Inc. makes no warranty of any kind, express or 
implied, including without limitation, any warranties of merchantability 
and/or fitness for a particular purpose. Datastorm Technologies, Inc. 
shall not be liable for any damages, whether direct, indirect, special or 
cansequential arising from a failure of this program to operate in the 
manner desired by the user. Datastorm Technologies, Inc. shall not be 
liable for any damage to data or property which may be caused directly or 
indirectly by use of the program. 


IN NO EVENT WILL Datastorm Technologies, Inc. BE LIABLE TO YOU FOR ANY 
DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR 
CONSEQUENTIAL DAMAGES ARISING OUT GF YOUR USE OR INABILITY TO USE THE 
FROGRAM, OR FOR ANY CLAIM BY ANY OTHER FARTY. 
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FroComm 2.4 Ordering Info 


ORDERING INFORMATION 


A FroComm registration licenses you to use the product on a regular 
basis. Registration includes mailed notification of updates and priority 
Peeeart On Our support BES. Registered users will also be granted access 
to a registered user only BRS to become available sometime in late 1986. 
Users need register only one version of ProCammy; registration includes 
licensed use of all upgrades. 


Individual registrations for FroComm come in three forms. The first, 
registration only, costs #25 and assumes you have already received a copy 
of the program from whatever source. We do not provide diskettes or 
manuals. The registration fee covers the use of the program. For #235 
dollars we offer a combination registration/diskette package. The 
diskette includes the latest version of the program, its documentation 
and some supporting programs and files. We alsa offer The Works!, which 
adds a printed, bound manual to the registration and diskette. Copies of 
The Works! are available for #50, 


In addition, evaluation disks are available at any time for #10, These 
disks do not include registration. The fee covers diskette, postage and 
handling. You can also send us a formatted disk, along with a postage- 
paid, self-addressed return mailer to receive a copy. 


Flease use the enclosed order form when placing an order. 


ORDERS OUTSIDE THE US: Flease use your Mastercard or VISA when ordering, 
or send checks drawn on US banks in US dollars. We can accept non-US 
currency: however, you must include an additional #5 to cover conversion 
and collection costs. Flease include an additional #5 to cover postage 
on orders of The Works! delivered outside af the US. 
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FroComm 2. 4 Ordering Info 


Remit tos Datastorm Technologies, Inc. Order Form 
reas Box i471 
Columbia, MO 65205 


Flease send: 


Pe oncom oli sti current oversior)) aks on sae eos OS 10.00reaq + 


(includes program and manual on disk, no registration) 


Scion: REQ 1 Sti atl OF) seals. 0 ee afelu ae Hawes » SS $ee5,00. ea  s 
(does not include disk) 


neon tenee entee sense neeen sone evens eases eevee wanes 


7, 


ProComm Registration/Disk Combo ......ee500.. @ $ 35.00 ea F£ 
(includes registration plus program and manual on disk) 


mate eee eens aes eee eens ssees sence seven sense 


ne EWC HS 8 cela el die wletel eo wle wiwielie eke Pita Wy cePo eee. O oO @ $ 50.00 ea + 
(includes registration, program and manual on disk, 
Plus printed, bound manual) 


Subtotal 


Less Discount 


(Missouri residents please add 6.225% sales tax) Tax 


Fayment bys { >) Check OL Me ( ) Visa oe 0 a a 


Se ee a ee no ee ee i 
Sa ee ee ee ee a ee 
en ee ee ee ie ee Oe et 
oe SS RAMS aaa eee fc 0 UO Ol oh dE nr 
ee ERPS Date oe 


Signature of cardholder: 


ORDERS OUTSIDE THE US: Use MC/VISA or send check drawn on US bank in US 
dollars. Otherwise add #5 for collection. Flease add #5 for non-US 
shipping of The Works! 


Sorry, no C.0.0D. orders will be accepted. 
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FroComm 2.4 Ordering Info 


Corporate and Quantity Purchases 


All corporate, business, government or other commercial users of FProComm 
must be registered. We offer quantity discounts starting at the eleventh 
copy. Corporate or site licensing is also available. 


For single unit orders, use the enclosed order form. We accept purchase 
orders in amounts over #1600 only. All other orders should be prepaid. 


Orders in quantities of less than 75 units are handled as bulk purchases. 
We can provide either the registration/disk combo or The Works!. 
Furchases of over 75 units may be handled as quantity purchases or as 
corporate licensing agreements. Licensing agreements allow duplication 
and distribution of specific numbers of copies within the licensed 
institution. Duplication of multiple copies is not allowed except 
through execution of a licensing agreement. Flease write or call for 
details. 


The quantity purchase discounts are as follows: 


O- 10 copies: na discount 
li~- 25 copies: 154 discount 
26- SO copies: 20% discount 
wl-100 copies: eJm Giscount 

101-200 copies: a0% discount 
201-200 copies: ade discount 
SO + COpLles: 40% discount 


ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT NOTICE. Discounts 
are not cumulatives they apply to single orders of like products only. 
Unit prices are the same as for individual users. 


WARNING: YOU MAY NOT USE FROCOMM WITHIN YOUR ORGANIZATION WITHOUT & FRIOR 
PURCHASE OR LICENSE ARRANGEMENT. 
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FroComm 2. 4 Freface 


FREFACE TO VERSION 2.4 


Quite a number of things have changed for this release, most notably the 
command language. See the accompanying file PRCM24.NEW for a complete 
list. Enough has changed that it might be wise to delete your existing 
.PRM files and create a new one. This may not be necessary in all cases; 
however, if strange things start to occur try that before calling in with 
any camplaints. 


Speaking of calling ins: our apologies to everyone who has tried to call 
the BBS and couldn’t get through. We are receiving a tremendous volume 
of calls and the phone is always busy. Please do not call the operator 
to complains there are no technical problems at present, just lots of 
callers. Late this year we will be adding a second line for registered 
users only who will receive priority support. 


And about support: while we try to answer all the mail, electronic and 
otherwise, that we get, it sometimes takes us a while to get around to 
it. Especially stuff from non-registered users. PFlease be patient, ane 
remember that we do not guarantee to provide support of any kind to non- 
registered users. 


About this manual: as the name implies, this is a reference manual 
describing the operation of FroComm. It is not intended as a tutorial on 
communications in general. For more general and introductory information 
on communications see: 


Glossbrenner, Alfred. The Complete Handbook of Fersonal Computer 
Communications, 2nd edition. New York: St. Martins Fress, 1985. 


Jordan, Larry E. Communications and Networking for the IBM Po, er 
edition. Bowie, Maryland: Robert J. Brady Company. 


WARNING: Version 2.4, like some previous versions, uses an overlay 
structure. This means that not all of the program is loaded into memory 
at once. Ss different sections of the program are required, they are 
read off the disk and into memory. All of the overlays are kept in the 
executable file FROCOMM.EXE. 


The practical implication of the overlay scheme is that FROCOMM.EXE must 
always be available to read overlays from. On a floppy system, this 
means that you cannot remove the disk on which FROCOMM.EXE resides fram 
the drive on which it was executed. If you do, the overlay linker 
assumes that the FROCOMM.EXE file is open and residing on the disk, and 
writes an updated file directory onto the disk, thereby averwriting any 
and everything on the diskette. 


Obviously this is not a problem for hard disks. The solution for floppy 
systems is simply not to remove the PROCOMM.EXE disk from the drive. You 
can easily change the logged drive (via the Alt-B or CHDIR commands) toa 
access files on other drives. 
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FroComm 2.4 Introduction 


ie OLSON RAGaPUT eer 1°O NN 


ProComm is a general purpose program designed to provide easy and 
convenient access to a broad variety of telecommunications tasks. Most 
of the program is written in the "C" programming language, with some 
assembly language routines for optimum performance. Included in its 
abilities are the sorts of features one would expect to find in highly 
sophisticated telecommunications softwares: 


* the ability to emulate a number of popular terminals; 
* adialing directory containing one hundred entries; 


* automatic redial facilities for connecting with hard to reach 
mumb er & § 


* several popular file transfer protocols including XMODEM, 
Kermit, Telink and mores; 


* command files to control automatic logon and unattended 
operations 


* a DOS gateway which allows you to execute DOS commands or other 
pragrams while you are still on line; 


*% a host of additional features, including keyboard macros, disk 
and printer logging and many others covered in detail on the 
following pages. 


Hardware Requirements 


PraComm requires a minimum of 130K of available RAM to execute 
properly~-that is, 130K in addition to the operating system and any 
resident programs, including such memory resident programs as Sidekick, 
Superkey, etc. If you are operating with less than 192K total RAM, 
FroComm might not be able to load. Tt runs under MS-DOS on the IBM FC, 
AT, AT or any close compatible, and may be used with color, composite or 
monochrome displays. 


Because FroComm may have a relatively large number of files open at 
once, you must assure that the FILES parameter in your CONFIG.SYS file is 
large enough ta accommodate them. We suggest using FILES=20 (or larger). 
Your DOS manual can give you more information on the CONFIG.SYS file, or 
see the Host Mode section of this manual. 


In addition, of course, you must have a working modem. The default 
settings in FProComm are all established for Hayes compatible modems. a 
your modem is mot fully Hayes compatible, consult your modem owner's 
guide for details on switch settings, commands, and so forth. In order 
for FroComm to work correctly, particularly in Host Mode, your modem’s 
Carrier Detect (CD) must be set to follow the true state of the carrier, 
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FroComm 2. 4 Introduction 


not forced true (or "high") by dip-switch settings. Similarly, the CD 
should not be set to follow DTR ("Data Terminal Ready") but rather to 
follow the "true state" or "RS-2352 Convention" (ar however your owner's 
manual state it). And finally, DTR should not be forced high by dip- 
switch settings; it, too, should follow real state. 


Frotomm Files 


When it is first loaded, FroComm creates several files which it will use 
on subsequent operation: 


FROCOMM.FRM, the default parameter file; 

FROCOMM.DIR, a dialing directory file; 

FROCOMM.EEY, a keyboard macro file; 

FROCOMM. XLT, the translate table file; 

FROCOMM.HST, the Host Mode audit trail; 
In addition, if you plan to use the Host Mode, you might want to create a 
file called FPROCOMM.MSG, which holds the Host Mode welcome message. 
The FroComm Environment Variable 
FroComm can use the environment variable FROCOMM= to tell it where to 
look for its files. FroComm first searches the current directory for 
necessary files. if the files are not there, then FroComm will search 
through the directory pointed to by FROCOMM= (if it exists). If the 
files are found in neither place, and must be created, they will be 
created in the directory pointed to by FROCOMM=. If the environment 
variable is not set, files will be created by default in the current 
directory. 
You can set the environment variable by issuing the DOS command 

SET FROCOMM=pathname <CR> 
where “pathname” is a fully qualified path name ending with a backslash. 
You may issue this command either from the command line or from a batch 
file. For example, if you have the command 

SET FROCOMM=C: \COMMA\FroComms 
im your AUTOEXEC file, FroComm will know to look for its files in the 
Cs \COMM\FroComm subdirectory, and you can use the program from anywhere 
on your system and still have just one set of FroComm files. He sure to 
remember to end the pathname with a backslash (\), or FroComm will get 
confused and have problems reading the necessary files. 
You can clear the environment variable null with the command 


SET PROCOMM= <CR> 


Consult your DOS manual for more information on environment Variables. 
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FroComm 2, 4 Getting Started 


You begin a PraComm Session by issuing the command 
FroaComm [/S] C/B] C/Ffilenameld C/MI C/D) 


where /S indicates sound effects, /B indicates black and white operation, 
fFfilename indicates a command file, /M indicates screen display mode, 
and /D indicates the presence of dual monitors. (Commands that are 
displayed in square brackets, e.g. ([C/S], are optional). 


Command line switches are optional, and may appear in any order. They 
must, however, be separated by at least one blank space. 


Including a "/S" on the command line suppresses FroComm produced 
sound effects. It does not, however, affect beeps (°G) coming from 
the remote computer or the alarm function, nor does it control the 
modem speaker. You can change the default sound settings after you 
have loaded FProComm by using the General SetUp aption of the Setup 
screen (Alt-S). 


The "/B" option may be used to run the program in black and white. 
This feature is useful if you have a composite monitor attached ta 
a color graphics display card. Specifying "/B" will tell FroComm 
to use only black, white and high intensity white for all displays. 
If the "/E" command line switch is amitted, FroComm will adjust 
Ltself for either color or monochrome operation. To make black and 
white colors the default, begin a FroComm session using the "/B" 
option, then save the current colors using the Alt-Z (set colors) 
ete ey 


Specify "“/F" with a filename to execute a command file immediately 
after loading FroComm. For example, to execute the command file 
"TEXAMPLE.CMD" as the first thing FroComm does after loading, enter 


FraCommnm /Fexample.cmd <CR> 
Command files are described in detail in Section 7. 


The "/M" option tells FroComm to perform screen displays using BIOS 
calls rather than writing directly to the screen buffer. This 
option is useful for running FroComm under multi-tasking operating 
systems. The screen write method is also selectable through the 
Serum NALe-Sip facility. 


The "/D" option is used when you have both a color and a monochrome 
display connected to your computer. This option may cause erratic 
behavior if used in conjunction with an EGA card/monochrome monitor 
combination. 


When the program begins it displays the FroComm logo and copyright 
notice. The first few times you use FroComm the program information 
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FroComm 2. 4 Getting Started 


screen will also appear. Once you have read the information screen, 
press any key to continue. You can also display the program information 
screen by pressing Alt-I from Terminal Mode. 


WARNING: Version 2.4, like some previous versions, uses an overlay 
structure. This means that mot all of the program is loaded into memory 
at once. As different sections of the program are required, they are 
read off the disk and into memory. All of the overlays are kept in the 
executable file FROCOMM.EXE. 


The practical implication of the overlay scheme is that FROCOMM.EXE must 
always be available to read overlays from. On a floppy system, this 
means that you cannot remove the disk on which FROCOMM.EXE resides from 
the drive on which it was executed. If you do, the overlay linker 
assumes that the FROCOMM.EXE file is open and residing on the disk, and 
writes an updated file directory onto the disk, thereby overwriting any 
and everything on the diskette. 


Obviously this is not a problem for hard disks. The solution for floppy 
systems is simply not to remove the FROCOMM.EXE disk from the drive. You 
can @asily change the logged drive (via the Alt-B or CHDIR commands) toa 
access files on other drives. 


Terminal Mode 


After the opening display and the program initialization, you are left in 
Terminal Mode. Most of your communicating will take place here. The 
bottom line of the screen is reserved as a status line, but the rest of 
the screen is open for use. When you first enter Terminal Mode, the 
screen will be blank except for the status line at the bottom of the 
Screen: 


+4. netes cones erens sence eeeee neces soees senes ments Sones seene sores ofe sateen woes eeete stone ress pense seeee notes of cress vesee evens cones oneee +e etene putes macnn ence anes tates este ca asses senes sense onene erees saete eonee aonte seven esos f- eoees veces ensee senes epeee eevee scone oof meee ee fe ee eee fe 
(ALT FiO HELFIANSI-BBS! HDX i300 NS81iLOG CLOSEDIFRT OFF ICRICR: 
fee eee wen wf em ea cf nee een mf ee ee we se a re 


This line indicates the current status of several of FroComm’s features: 


ALT FiO HELF indicates that you can press Alt-FiG to activate the 
FroComm Help Screen. This section of the status line also 
indicates what is currently occurring. For example, if you 
activate the screen dump, then the words "SCREEN DUMF" will replace 
Reto e dO2 HELPS. 


The next segment of the status line ("ANSI-BBS") indicates the 
currently activated terminal emulation. 


The third status indicator is for duplex: "HDX" indicates half- 
duplex; "“FDX" indicates full-duplex. 


In the fourth block the status indicator reflects the modem line 
settings, in this case 300 baud, no parity, 8 data bits, and 1 stop 
basen 


The LOG status indicates whether you have activated the feature 


which allows "logging" incoming data directly to disk. i+ that 
feature is active, then the indicator will say "LOG OFEN”. 
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FroComm 2. 4 Getting Started 


FroClomm allows the option of sending incoming data directly to your 
printers; if you select this option, then the printer status 
indicator will say "FRT ON"; otherwise it remains at "PRT OFF". 


Tf you activate the feature which adds a line feed to all incoming 
carriage returns, the next indicator will show "CR-LF"; otherwise 
it remains at. just "CR", 


Similarly, the final item indicates the status of the CR/CR-LF 
Qutput feature. 


Most FroComm features are called from Terminal Mode and are executed in a 
window which leaves your original screen intact. FPress AlLt-F1O to 
display a help screen which lists all available commands. You may select 
commands either from the help screen or directly from Terminal Mode. You 
can return toa Terminal Mode from most windows by pressing <ESC>:. 


Terminal Emulations 


Most keyboard and screen functions will operate locally as you expect 
them to. What they do on the remote computer depends on which terminal 
emulation you are using. FroComm supports ten popular terminal 
configurations: 


peter ae Od —TBEEIY 1-206 TRUCE Vioos 
~ Televideo 910/920 ~ Televidea 925/950 ~ Wyse 100 
~ Lear Siegler ADM-3/53 ~ Heath/Zenith i9 ~- ANST-BRS 


i 
3 


ADDS Viewpoint 


Appendix A contains a complete list of the functions supported for each 
terminal. 


To change the emulation currently in use, select the Terminal SetUp 
aption from the main SetUp screen (ALt-S), or use the Emulate command in 
a command file. 


Line Settings 


ProComm supports a variety of communications configurations. You may 
select the baud rate, number of data and stop bits, parity, and duplex. 
The program defaults to 200 baud operation, with & data bits, 1 stop bit, 
no parity and full duplex (echo off). 


Use the Alt-F (Line Settings} command to review or change the active line 
control settings. After opening the Line Settings window, FroaComm 
displays the current settings. Enter a number from 1 to 12 to change to 
& predefined setting. Use the numbers 13 through 19 to set up a 
customized configuration. Enter 20 to select COM] as your active port, 
fone Use ,COM2, 22 for COMS, and 23 for COM4. 


Use the Save option (24) to make the new configuration your default. If 
you change the parameter settings without saving them to disk, they will 
be ugecd only for the current session, and will return to their original 
settings the next time you use FraComm. 
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FroComm 2.4 Getting Started 


Once you have made your selections, press <ESC> to return to Terminal 
Mode. The new parameters are now in effect. 


String Translation 


There are a number of situations in which FroComm will translate strings 
going to or coming from the modem. The strings that are translated 
include the modem initialization string, the modem command, dialing 
directory numbers,. long distance codes, keyboard macros, modem connect 
hessages and several script commands. The translation allows you to send 
carriage returns, escape codes and other control characters to the modem, 
as well as providing a pause feature. FroComm translation characters can 
be specified in the General SetUp screen. Translation characters are 
provided for CR, ESC, CTRL-char and pause. 


The default CR translation character is the exclamation point ("79"), 
Anytime FroComm encounters the CR translation character in one of the 
strings mentioned above, it replaces that character with a CR (ASCII 13). 
To send the character without translation use two of them together. Far 


example, when "!" is the CR translate character, a keyboard macro set to 
"PASSWORD!" sends the string "PASSWORD" followed by a carriage return. A 
keyboard macro set to "GO AWAY! !" will be translated as "GO AWAY!". 


Since two of these characters in a row are translated as the true 
character, some other method is necessary to send two adjacent carriage 
returns. You can do so by using the CTRL-char translation described 
below. For example, if the CTRL translate character is set to the caret 
C""") the string "MM" is translated as 2 carriage returns (because 
Cerl-Mirs oa: CR). 


The default ESC translation character is the vertical bar ("7"). When 
FroComm encounters this character in one of the translated strings, it 
replaces it with an ESC (ASCII 27). Again, to send the character without 


translation use two of them together. For example, when "i" is the ESC 
translation character, a keyboard macro set to "“iC2d" sends the VT1O0O 
command for clear screen (ESC [C 2 J). A keyboard macro set to “ii box 


ii" will be translated as “i! box i". Again, since two consecutive 
translation characters are translated as the true character, some other 
method is necessary to send two adjacent escapes. As with the CR 
translation character, you can indicate two consecutive escapes by using 
the CTRL-char translation described below. If, for example, the CTRL 
translation character is set to the caret ("*") the string "“C°C" is 
translated as 2 escapes (because Ctri-C is am ESC). 


The CTRL character translation is slightly different. It is used as a 
lead-in marker to indicate that the following character should be 
interpreted as a CTRL character. For example, using the default CTRL 


translate character "*" (the caret), the string "“C" would be interpreted 
as a Ctrl-C (ASCII 3). Again, two translation characters together are 
treated as the actual character, so "°C" would be translated as "°C" 


(the caret character followed by a capital C). 


The final translation character provided is the pause. If this character 
is encountered during translation, FroComm will pause for i/72 second 
before doing anything else. The default translate pause character is the 
tilde ("*"). This translation character is significantly different from 
the others in that two pause characters together cause a 1 second pause, 
three together cause a one and one-half second pause, and so forth. 
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FroComm 2.4 : Getting Started 


Multiple pause translation characters are not interpreted as a single 
character. If you wish to actually send that character (e.g. the tilde) 
you must change the setup for the pause translation character. 


It is important to note the difference between the translation pause 
character and a modem pause character. The translation pause character 
CAauUSesS a pause in characters being sent to the modem. This character is 
appropriate for pauses around a modem escape code, as in a hang-up 
string, or for allowing the modem to respond to something before 
continuing. On the other hand, a modem pause character, such as the 
comma used by Hayes, causes a pause in characters sent from the modem to 
the phone line. tt iS appropriate for such tasks as waiting for a second 
dial tone when dialing out through a FBX or office telephone system. The 
translation pause character and the modem pause character are not the 
game and should not be confused. 


Help Screen 


The Help Screen lists the command keystrokes used to execute a FroComm 
feature. The Help Screen is displayed when you press ALt~-F1O while in the 
Terminal Mode. Fressing ALt-F1O produces this screen: 


MAJOR FUNCTIONS UTILITY, FUNCTIONS FILE FUNCTIONS 


aelang Directory Alt—-D Program Infop,..... ~Alt-1, Send files ... PqUp 
(Automatic Redial.. Alt-R Setup Screen ..... Alt-S Receive files FgDn 
‘Keyboard Macros .. Alt-M Kermit Server Cmd Alt-K Directory .... ALt-Fi 
{Line Settings .... Alt-FP Change Directory . Alt~-B View a File .. Alt-Vi 
‘Translate Table .. Alt-W Clear Screen ..... Alt-C Screen Dump .. Alt-Gi 


stat ae 
it PF Logt. eeaain Help id 
ie a i 


BRE IGIE ads a, aon So wee = 8 Alt-A Toggle Duplex .... Alt-E Log Toggle .. Alt-Fii 
GE IG Ge ws mie el mie S, Se) Ha ee Alt-X Hang Up Phone .... Alt-H Log Hold .... ALt-Fei 
east MOdeG «6. saws» Alt-G Elapsed Time ..... ALt-T i 
Mpeeode sa avast OALE—O. Print Gn/Off es. es enAbt-b 
{DOS Gateway ..... ALt-F4 Set Colors ...eeae ALt-Z 


‘Command Files ... ALt-FS Auto Answer ...02. ALt-Y H 
PSeauSsH lay macnn. s GALESFO Toggle CR-CR/LF os, ALt-F3 i 
H Break Fey «<e.0.268 Alt-F7 i 


You can select any of these features from the Help Screen or directly 
from Terminal Mode. The Help Screen is merely a help, mot a required 
step for reaching the options, nor do you need to return to the Terminal 
Mode before selecting one of the options. Each of the features listed in 
the Help Screen is described in more detail in Section 4, and many are 
considered in still greater detail in other sections of this manual. You 
can return directly to Terminal Mode from the Help Screen by pressing any 
non-command key. 


Rr cing FProComm 
You can exit FProComm at any time from Terminal Mode or the Help Screen by 


pressing Alt-X. You will be asked to confirm the decision to leaves 
press "Y" to exit or "N" to resume work. 
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FraComm 2. 4 The Setup Screen 


Bales! alee Fac ees SBP Sue Ree N 


FroComm allows you. to define many of your own power-up defaults for 
system parameters. You can also change a setting temporarily, use it for 
the current session, then automatically go back to your default settings 
for the next session. Setup is reached via the ALt-S command. It is 
divided into 6 sections: Modem Setup, Terminal Setup, Kermit Setup, 
General Setup, Host Mode Setup and ASCII File Transfer Setup. 


Press Alt-S from the Help Window or while in Terminal Mode to activate 
the SetUp facility. The screen will clear and present you with these 
aptiongss 


LoS MODEM SE Tur 

=) TERMINAL SETUP 

oo? VRERMGT OSE TOP 

4) GENERAL SETUP 

So HOS TR Move SETWe 

OG? "AS it TRANSFER SETUP 
Bt (SAVE “SerUr TO DISK 


You can @xit the main setup screen at any time by pressing “ESC? any 
changes you have made but not saved to disk (using the "S" option from 
this screen) will be in effect only for the current FroComm session. 


Select a setup section by typing its number and pressing «<CR?. The 
screen will clear and display the current settings for that section. To 
change a setting, enter the number of the setting you wish to change and 
press <CR?. Then make your change as described below. if arter 
selecting a parameter, you decide not to change it, you can retain the 
current value by simply pressing <ESC:. 


If the parameter you have selected requires a string, type in the 
characters for the new string and press «CR. Note that pressing «CRS 
without typing any characters will clear the settings if you wish te 
retain the current string, press <ESC-:. 


Some parameters offer you a selection of valid values. Fress the space 
bar to cycle among the available values. When the value you desire 15 
displayed, press <CR? to accept it. 


If the setting you are changing requires a number, enter the new number 
and press <CR>. FroComm will check to make sure that the number falls 
within a valid range. If you have selected a number outside that range, 
FroComm will inform you of the error and allow you to select another 
rum er . 


After making your changes in a particular section, press “ESC? to return 
to the main SetUp Menu. If you wish to save your changes to disk, select 
so trom that menu. If you choose the Save option, the current settings 
will become your power-up defaults. If you do not save the setup, the 
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FroComm 2.4 The Setup Screen 


changes you have made will be in effect for only the current FroComm 
SeESSl0n. 


Modem Setup 


If you select option 1 from the main SetUp Menu, a screen similar to the 
following will appear: 


oo ee eee OE Ld Rc MODEM SET WE anf covs snes wets sve tee eens ner ents ontn nate eves ant ents sant ante ems son nna ges ata tes aes wnt 


1) Modem init string .... ATEO S7=60 Sii=S5 Vi Ki SoO=0! 
2) Dialing command .....«. » ATDT 
Sebialingwend suttix) .sed! 


4) Connect string .a.nae « SGUNNECT 

5S) No Connect string i .. BUSY 

Se No Gonnectk string 2° 2.) WwOICE 

7) No Connect string 3 .. NO CARRIER 
8) No Connect string 4 .. 


Smenangui Sth MG kes .0eeee 8 ee Y YALTHO! 


10) Redial timeout delay . 30 
11) FRedial pause delay ... 2 
OPA LONG > ESC exit 


You may change these options by typing the appropriate selection number. 


1) Modem init string 
The modem initialization string is sent to the modem every time you begin 
a FroComm session, and again whenever you exit Host Mode. Tt can be up 
to 46 characters in length, and may contain carriage returns or control 
characters using the translate conventions described in Section 2. Modem 
initialization strings vary among different types of modems. The 
default, configured for Hayes or compatible modems, is ‘AT EG S740 
S$1ii=SS SO=O0 Vi X1!', where 

AT is the command prefix 

EQ sets modem echo of commands off 

S7=60 sets the maximum wait time for a carrier at 60 seconds 

Sii=55 sets touch tone spacing (and is very fast) 

SO=O turns of f the modem’s auto answer feature 

Vil activates verbal result codes 


Xi activates the extended result codes 


| causes FroComm to send a CR to the modem at the end of the mocemn 
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FroComm 2.4 The Setup Screen 


initialization string. 


Be sure to include that last “!" if you need FroComm to send a CR at the 
end of the command. 


The initialization string may be tailored to suit your particular modem 
and needs. Consult your modem user’s guide for details regarding the 
aperation and available commands for your modem. 


2) Dialing command 


The dialing command is used to instruct the modem to dial a number. Lt 
is sent to the modem by the Dial (Alt-D) and Redial (ALt-R? functions, 
followed by the number to dial and any long distance codes you might 
specify. The default is ‘ATDT’ where 


AT is the command prefix 
D is the dial command 
T turns on touch tone dialing (F is used for pulse dialing) 


The modem dialing command may contain imbedded pauses, CRs, ESCs and CTRL 
characters using the conventions on string translation described in 
Section 2. 


3S) Dialing cmd suffix 


The dialing command suffix is sent to the modem at the end of a dialing 
command to indicate that the command is complete. The default command is 
"iu which is translated as a CR, and should be correct for most modems. 


& complete dialing command includes the Dialing Command, the telephone 
number to be dialed (and any associated codes or numbers), and the 
Dialing Command Suffix. & local call using tone dialing, for example, 
might look like ‘ATDT 123-4367!" where 


ATDT is the dialing command 


carters 


23-4567 is the number being dialed 
and 


' (translated as a CR) is the dialing command suffix 


4) Connect string 


The connect string is the message your modem sends to ProComm to indicate 
that a connection has been made. The default is "CONNECT". FroComm uses 
this value during automatic redial (Alt-R) to determine when a connection 
has been made. Note that this parameter must be set correctly (including 
upper or lower-case) for auto redial to work. Translation is in effect 
for this string. For example, if your modem sends ‘<LF?<LFe<CR>° to 
indicate CONNECT (as the IBM FCir modem does), set the Connect String to 
eee ro (A Ctrl-J is a LF, and a Ctril-M is a CR). 
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FroaComm 2.4 The Setup Screen 


2) =~ 8) Modem No Connect strings 

These strings are also used by the auto redial feature. They should be 
set to modem messages that indicate that a connection was not achieved. 
The defaults are "BUSY", "VOICE" and "NO CARRIER"; a fourth message may 
be added by selecting option number 8. Again, these strings must be 
exact matches to the messages your modem displays, including upper and 
lower case. Some modems do not support these call progress monitoring 
features, although most support at least "NO CARRIER". 


9) Hang-up string 


The hang-up string is the command sent to the modem to cause it to hang 
up. When Alt-H (Hangup?) is pressed, FProComm first attempts to hang-up by 
dropping the Data Terminal Ready (DTR) line. If that attempt fails 
{determined by checking Carrier Detect [CDI]), FroComm will send the 
hang-up string to the modem. The default, set up for Hayes and 
compatible modems, is "™*™%+++*°™%ATHO!", where 


Tee Phe he 


is a l i/S second delay 


+++ is the modem escape sequence to drop into command mode 


Pee Me Ne 


is another 1 1/23 second delay 
AT is the modem command prefix 

HO is the hang-up command 

' gends a <CR> 


The "*" and "!'" characters are translated by FroComm, not the modem (see 
Section 2 on string translation for information about how to change these 
characters). The "+++" surrounded by the 1 1/2 second pauses causes the 
modem to go into command state, where the hang-up command is then issued. 
For more information see the Alt-H command, in Section 4. 


10) Redial Timeout Delay 


This command determines the number of seconds that FroComm will wait 
during Redial (Alt-R) for a Connect or No Connect response from the 
modem . If the timeout delay is exceeded before a modem response is 
received, FroComm will cycle and attempt another redial. You should be 
gure that your modem‘’s timeout value is set higher than this timeout 
Value, or strange results may occur. 


This value may also be modified on the fly during a redial attempt. See 


Load 


Section 5S on Redialing for more details. 


li) Redial Fause Delay 


The redial pause delay is the number of seconds that FroComm will pause 
between each dialing attempt during a redial. The pause is previded to 


Copyright (C) 1986 Datastorm Technologies, Inc. S04 


i sh » 
ad Gfucna vert .atuteat te ther asus ait vat 
-baveiringe Jon #8u agttoennos Bo gers 89 
(an Spsecem inue> se" AST RAD OM" bem + aes Ya 
av saum epninte seeds .tepr 8 Re 
brs ~eqqu pnibuiont eye! aéib webom WOY #ep22 
eninotinom esesposq Iles segndy t4bqque Fensob To". 
“ARTHAS OF" saeat te Saathue Jeaa ig 


pied ot xf pevas oF mMeahon add oF Fass briamme= ent 2? pres 
qguvonernt of etqnette tgeni> maidens , bexes ig 2) CanapneHi HA 
ells? taoneste tend +1 mal (ATO) VGRee Lar beet’ ated wel: re 


= oe} farmse ifliw. macodo7Ss » (LG) +> ea tad sei cy Ae ry 3 doxena vid. ot 
BOs gave 307 gu Jae ,ofusetabh eAt em boat aid od pak a 
sharks "OHTA Sea orn” ff . etek ; Te 


Ve leat cae SAL £3 ei 


‘Don Onamnos ogni gost oo @pneupes eonpee mokom ans ak “an 


valob boo swe $s i “eritons ah 
KLIS IQ SramNg > asbom eri ori: 
Drretadigys qQu-pimed sit zi @ 

CADS é: ybivee : 


’ 

Vevom @t2 Joo »mmnol3en) yd begalense rh eta @netad .edS mr bea 
[2082 OF worl tuods meitenrwmdAk 3903 aotgedeasa pnive nc 
7 eseaueq bnesse S\l f sie vd behnqvo Wwe "+++" opp eee 
= mnOS GM-onen Sit eerie Siege bnanmnep eons og 
NO fI3e8 ot ,bd6amen Hola SAP see Ne LIers € 


ii 


yelled susemiT ts 
2 : i ny 7 


Jim Lisw ameoesa J609 asfnooe@ to datigun say eartimaee 


217 mo») seneqes) Ipenned @A 4a. t2enAnd SB 78t (Hees ; 
2i Senoqeen mehom & soled hehe = > 2 @f yatah tuasm dé. erlt : 
sd biwode vo leLbe Serltonm Sometis bas efoya fin - 
twoeM is Sfds ocsdt yeipin tee ee eulay Fugees 2 ms wo) 
j W350 hort Siloti aarees i: 


i 
i)" ' 


ae® .tanetie darben «& pnitub Wile edt aa bedtibon a Op is-ymme 
| Rn e tel s10M. nett ant re. 


Pi 4 
anusq thew mmoga4 sede 2bnoaee 46, sada 
oF? bebivowtg al SZusE. wil -teiber ie ¢ 


_ : 
2 ' 


. 4 oak! amie 


+ 
Ay 


FroaComm 2.4 The Setup Screen 


let the modem settle down between calls. The default is 2 seconds, and 
the minimum pause time is 1 second. 


Terminal Setup 


When you select the Terminal SetUp option (number 2), you will be 
presented with a screen similar to the following: 


se st it et tt se ene eee = TERM TMAL, SETUP nme eee ee ee ee ne ie 


ipetterminal emulation ... ANSI-BES 10) Enquiry ...cennene OFF 
UREN) otha w wee aa ela ne we HALF 11) Break Length (ms). 350 
PimLow Controls <.2is . wate (NONE 

4) CR translation (in) .. CR 

5) CR translation (out) . CR 


6) BS translation .....6.. DEST 
¥) BS Key definition <... BS 
8) Line wrap .wnanananae sak Pr 


Seer oil! 6. awe cee SG ON 


Select a parameter to change by entering its mumber followed by <CR>. 


1> Terminal Emulation 


Terminal emulation means using your computer to act like a terminal. Use 
this parameter to select the terminal you wish to emulate. All of 
ProComm’s terminal emulations are described in detail in Appendix A. 


After selecting option 1, press the space bar until the terminal you wish 
to use is displayed. Then press <CR> to make that terminal the current 
emulation. Take care to insure that the rest of the settable terminal 
parameters match what is expected for the terminal type you select. The 
DEC VT1iOO is the most popular terminal emulation for our users. For 
general BES work, we suggest ANSI-BES. 


2)? Duplex 

You can control the default duplex setting here. Your choices are full 
duplex (no echo) and half duplex (local echo). The system administrator 
of the system you are calling can tell you what is appropriate far a 
particular system. 

In general, if what you type is not displayed on the screen, but should 
be, try going to half duplex. If you see two of every character you type 
(e.g., “ttwwoo ooff eevveerryy cchhaarraacctteerr"), change te fault 
duplex. Duplex may also be changed on-the-fly using the Alt-E command. 


3) Flow control 


Flow control (sometimes called "handshaking") is a method computers use 
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FroComm 2. The Setup Sereen 


to control the way they talk back and forth. It‘s similar to a traffic 
light in that it determines in which direction traffic can flow at what 
time. The only flow control that FroComm currently supports is XON/XOFF, 
s0 your choices for this parameter are XON/XOFF or NONE. If you wish to 
use flow control set this option to XON/XOFF; otherwise select NONE. 
FroComm performs XON/XOFF at the interrupt level. To prevent deadlock 
because of extraneous XOFFs caused by line noise, FroComm allows you to 
reset the XOFF flag. If you see a message on the status line that 
indicates that an XOFF was received, but you think it is not valid, press 
ESC? to clear the XOFF flag and allow you to continue work. 


4) CR translation (in) 


This feature is used to set the power-up default for incoming carriage 
return translation. 


FroComm needs a CR/LF sequence to correctly handle lines sent to it by a 
remote. The CR (carriage return) moves the cursor to the beginning of 
the current line, and the LF (line feed) moves it to the next line. Some 
systems send only a CR and expect you to provide the line feed, while 
others send both the CR and LF. 


When set to CR, FroComm leaves incoming carriage returns alone, and 
assumes that the remote system will also send a LF. When set to CR/LF, 
FroComm automatically adds a LF to any CR received. if the lines coming 
from the remote write on top of each other, you need to set this 
translation to CR/LF. IF lines appear to be double spaced, go to CR. 


Most TTY (non—full screen) applications (including most BBS’s) send bath 

the carriage return and line feed, so the FroComm default is CR. You can 
change this setting on-the-fly without affecting the power up default by 

using the Alt-FS3 command. 


4 


a CR translation (out) 


Just as different systems send different line end sequences, they also 
may need to receive different line end sequences. Some systems need only 
a CR, while others must have a CR/LF combination. 


Use this option to set the FroComm power up default for outgoing carriage 
return translation. If set to CR, outgoing carriage returns send only 
the CR. If set to CRYLF, any carriage return sent by FroComm to the 
remote unit will have a line feed appended to it. 


The FroComm default is to send the CR only. 


6) BS translation 


A backspace (BS) may need to be interpreted differently depending upon 
the terminal emulation in use. In most cases it is "destructive" (DEST); 
that is, the cursor will both move to the left and delete the character 
in that position when the BS key is pressed or a HS is received from the 
remote. In other cases, the VT100 for instance, the BS behaves like a 
cursor-left command, merely moving the cursor without erasing any 
characters; it is thus "non-destructive" (NON-DEST). You may choose the 
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FroComm 2.4 The Setup Screen 


correct behavior for your application using this parameter. The FroComm 
default is DEST. 


7) BS key definition 


Normally, when the backspace key is pressed it sends a BS (ASCII &) to 
the remote units by using this option, however, you can force FroComm to 
transmit a delete (DEL, ASCII 127) instead. The BS key definition option 
is especially useful when the terminal being emulated has a Del key where 
the ITBM-FC has its BS key. 


The FroComm default is to send a HS. 


8) Line wrap 


If an incoming line is greater than 80 characters long, it can be handled 
in two different ways. It may be truncated (cut off) so that characters 
past the 8Gth are lost, or it may be wrapped around ta continue on the 
next line. This setting controls which method FroComm will use. 


If line wrap is set ON, lines greater than 80 characters in length will 
wrap around and be displayed on the next line. With line wrap OFF, 
however, lines greater than 80 characters in length will be truncated. 


Since most terminals truncate lines, the FroComm default is line wrap 
ORF . 


9) Scroll 


The scroll parameter controls what happens if FProComm receives a hercar 
CR/LF) while the cursor is positioned at the bottom line. If the scroll 
option is set ON, FroComm moves all the lines on the screen up one line 
{losing the top line) and the new line is printed in the blank space at 
the bottom of the screen. If scroll is OFF, the cursor returns to the 
far left column, and the new line overprints the old. Normally this 
feature will be set ON (the default), although for some full screen 
applications you may need to inhibit screen scrolling. 


10>) Break Length (ms) 

A break is a spacing condition on the line. It is often used to get a 
remote system’s attention. ProComm uses Alt-F/ for CTRL-BREAE on IBM 
machines)? to signal a break. 

The break length option allows you to set the length (in milliseconds) of 
the break signal. The default is 350 ms, and is sufficient for most 
SYStems « 

Meowenquiry) <Ctril-E) 

Some systems send an ENG control character (Ctrl-E, ASCII 5) and expect 


an identifying sequence to be returned. lf Enquiry is set ON, FroClomm 
will respond to an ENG by sending the keyboard macro assigned to Alt~-O. 
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FroComm 2.4 The Setup Screen 


If Enquiry is set OFF, the ENG will be treated as just another character. 


A third option is available for users of the CompuServe Information 
Service (CIS). CompuServe uses an ENG to signal the beginning of an 
automatic file transfer. If you wish to be able to perform automatic 
file transfers using the CompuServe ‘B’ protocol while logged on tigi. 
set this option to CIS B. Be sure, however, that you are not set to CIS 
B while logged onto other systems, ar strange results may occur. 


The FroComm default for Enquiry is OFF. 
Kermit Setup 


The Kermit Setup section provides control over a number of Kermit file 
transfer parameters. After selecting option 3 from the main SetUp Menu, 
you will be presented with a screen similar to the following: 


Ce et MEM ee TUR tee aeesca es Sect 


PemGentrol quote char ..«. 35 (ASChl) 
2) Maximum packet size .. 90 
3) Pad character ..... Ware ui (ASCIT) 
4) Number of pad chars .. © 
Syecth bit quote char ... 38 ‘ASCII? 


Poe Handshake char. «eeiee0. O (ASCII) 
Voenc of Line char. «sss 13 (ASCIT 
S) File type ..saes. Pic on Here eR eN 


9) Block check type ..... 1 BYTE CHECKSUM 


orogens ears “ssc ost ctony aha sums Sutin oboe inde etex pases sense sosnapvor rssh ssa os din senses ano Wees et eave snaus ise vorss oowb ete onteebnnes abet cures sien, erent aaton saree oween evbe| stews tees basbe sbeme Same. ene sttte ours centered efang very Rotem HnesI¥=e SES SSE SEN 


oe BN —> ESG Exit 


We do not have the space here to give a Kermit tutorial. If you do not 
know what these elements are, you probably should not change them. 
Consult the system administrator for your system if you have any 
questions regarding their Fermit imstallation. 


One parameter worth mentioning is the Handshake character (option 4). In 
most implementations you should use the default of 0, which implies no 
handshaking. In the case of line at a time (not full screen) IBM 
mainframe access in half duplex, a handshake value of ASCII 17 is 
appropriate. 


& further discussion of ProComm’s Kermit implementation is available in 
the file transfer section, Section 64. 


General Setup 


Selecting the General Setup option from the main SetUp Menu will cause 
the following screen to appear: 
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1) Editor mame ....0005« 
2? Default d/l -path «... 
3) Default log file ..... FROCOMM.LOG 12) Xlat pause character . ™* 
ree ocreert Gump file... > PROCOMMVIMNG “13 Klat CR chafacter .... ! 


3) Sereen write method .. DIRECT 14) Xlat CTRL character .. 

6) Translate table ...... OFF Tone als Cha ae eR! ec, I 

me SOUnNO Effects =. ..s «ess ON 

Perv cat Th SCUUANIC) os alg a 6 wie ww ON 16>) Aborted downloads .... KEEF 
9) Alarm time (secs) .... 5 ; 

Pees pLoding widows ....«° YES 17) Transmit pacing (ms) . 3O 


11) XMODEM mode ......... NORMAL 
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OFTION => ESC -Exit 


1) Editor name 


Use this parameter to name the program to be accessed by the Alt-A 
(Editor) command. Fressing Alt-A will execute this program from within 
FroComm, without the necessity of popping out through the DOS Gateway or 
exiting FroComm. This is very handy for editing or listing a file while 
online, as well as for developing FroComm command files and many other 
tasks. 


The Editor name parameter can be specified in a number of ways. It may be 
& complete filename with path (e.g. Cs\WP\EDIT\EDITOR.EXE), just the 
program name without extension (e.g. EDITOR) or anything in between. icf 
no path is specified, FroComm will search the directories specified in 
the environment variable PATH for the indicated program. 


FroComm can run almost any .EXE or .COM program using this feature as 
long as there is enough memory available. Feep in mind that ProComm 
itself requires approximately 130K of RAM, and the operating system 
another 17-30 (depending on the version). Other resident programs (such 
as Sidekick) can take up even more. If you are running only 192k (the 
minimum possible to operate FroComm), you may not have enough memory to 
lead the desired program unless it is quite small. 


The Alt-A command cannot be used to execute a batch (.BAT) file. 


2) Default d/l path 


This option allows you to specify where you want to put files that you 
download. If no path is specified, downloads will be directed to the 
currently logged drive and directory. If a path is specified, the file 
will be placed in the named directory. For example, if this option is 
set toa 


C: \COMMNFROCOMMNDLN 


then all files that you download will be placed in the \COMM\PROCOMMNDL 
directory on drive Cs. Keep in mind that the pathname must end with a 
backslash ("\") in order for FroComm to interpret it correctly. Consult 
your DOS user‘’s guide for details about directory naming conventions. 
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FProaClomm i. 4 The Setup Screen 


You can override the download directory option when using the file 
transfer protocols which require you to name the incoming file (XMODEM, 
YMODEM, and ASCII). To do go, include a path when specifying the 
filename to download. For example, when downloading a file using the 
XMODEM protocol, FroComm will prompt you for the name of the file to be 
downloaded. If you specify 


Cz \BASIC\FILENAME.EXT 


as the filename, the file will go directly to the \BASIC directory on the 
Cs drive, and not to the default download directory. The other file 
transfer protocols include the filename as part of the data being sent, 
so you will not be prompted for the filename to use and thus cannot 
override the default download directory option. 


os) Default log file 


When you activate file logging (ALt-F1), FProComm will prompt you for the 
name of the log file to use. Fressing “CR? without naming a file directs 
the log to the default file. Use this parameter to set the default name 
for the log file to use when file logging is in effect. [It the file 
exists, FroComm will not overwrite existing data; rather, new data will 
Beveappended to the end of the file. If the file does not exist it will 
be created in the current directory and the data will be saved to it. 


4) Screen dump file 


This option names the file to which FroComm will append screen dumps 
fait) . If the screen dump file does not exist when Alt-G is pressed, 
it will be created in the current directory. Again, FroComm will not 
overwrite an existing file, but will append the screen dump data to the 
end of an existing file. 


5) Screen write method 


FProComm can use either of two different methods to perform its screen 
Wich rng « In the first method, characters are written directly to the 
screen buffer memory area. In the second, characters are written using 
BIOS (operating system) function calls. Normally you would use direct 
Screen writes because they are much faster. In some cases, however, such 
as under multi-tasking operating systems or when you are using a not-sa- 
compatible computer, you might wish to use the BIOS. The FroComm default 
is to use direct screen writes. You may also select BIOS mode using the 
"7M" command line option. 


©) Translate table 


This setting controls whether or not FroComm uses the translation table 
to translate, or strip, incoming characters. Selecting YES causes the 
translate table to be activated immediately, as well as on program 
startup. FroComm defaults to NO. The translate table may be defined and 
toggled ON/OFF using the Alt-W command from the Terminal Mode or from the 
Help Screen. The translate table is discussed in more detail later in 
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Frolomm 2.4 The Setup Screen 
this manual. 


7) Sound effects 


This option controls the use of FProComm—produced sound effects. These 
sound effects include the open and close window sounds, as well as some 
other audible feedback. It does not control the alarm function, sounds 
generated by the modem or beeps (Ctrl-G, ASCII 7) sent from the host 
unit. Sound effects are ON by default, and may also be controlled using 
the "/S" command line option (see Section 2). 


8) Alarm sound 


This setting controls whether or not the alarm is audible. The alarm is 
used to indicate the end of file transfers, connects during re-dials and 
other events. It may also be activated by the ALARM script command. If 
the alarm sound is ON, these events will trigger a ringing sound which 
Will continue for the number of seconds specified by the alarm time 
setting. If the alarm sound is OFF, the appropriate message will flash 
for the indicated time but will be silent. By default, alarm sound is 
ON. 


9) Alarm time (secs) 


Use the alarm time setting to determine the time (in seconds) that you 
wish the alarm sound to ring. If, for example, you want the file 
transfer alarm to ring for two minutes, then set the alarm time to 1230, 


iO) Exploding windows 


FroComm makes extensive use of windows in its operation. This option 
controls the manner in which those windows appear. If you select YES, 
FroComm will use "exploding" windows, i.e. windows that start small and 
rapidly grow to full size. If, on the other hand, you select NO, then 
Windows will appear without expanding frames. By default FProComm will 
use exploding windows. This is purely a cosmetic effect, and has no 
bearing on the functionality of the program. 


11) XMODEM mode 


Some remote systems, such as CompuServe, cannot handle the normal XMODEM 
error timeout periods. They need a less critical timing situation. For 
these systems, set the XMODEM mode to RELAXED to avoid file transfer 
aborts resulting from timing errors. In most cases, however, this option 
should be set to NORMAL. 


12) Xlat pause character 
The translate pause character parameter is used to set the character 
which is to be interpreted as a pause during string translation. ProComm 


uses the tilde (*) as the default. See Section = for more details on 
string translation. 
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FroComm 2.4 The Setup Screen 


13) Xlat CFE character 


This parameter sets the character which is to be interpreted as a 
carriage return during string translation (the translate CR character). 
By default, an exclamation point (!) is used. See Section 2 for details 
about translation characters. 


14) Xlat CTRL character 


The translate CTRL character parameter is used to set the character which 
is interpreted as signaling a control character during string 
translation. The default is the caret (%). Section 2 has more details. 


15) Xlat ESC character 


Use this parameter to set the character which is to be interpreted as an 
ESC during string translation. By default, FroComm uses a vertical bar 
i). See Section 2 on string translation for more details. 


14) Aborted downloads 


This setting will determine the disposition of files that are aborted 
during downloads. If it is set to KFEEF, these partial files are kept on 
the disk and are your responsibility. If it is set to DISCARD, they are 
erased from your disk when the download aborts. By default, aborted 
downloads are kept. 


17) Transmit pacing (ms) 


This parameter controls output pacing of strings. Strings that are paced 
include all the setup strings, macro keys, and terminal control sequences 
such as function keys and cursor control. This option is provided for 
those systems too slow to handie FroComm’s speed. 


Host Mode SetUp 


Selecting the Host Mode Setup option from the main SetUp Menu will cause 
the Host Mode SetUp screen to appears 


1) Host ID string ....... Welcome to FroComm Host! 
2) Auto answer string 2... ‘**+4++*"*ATSO=1 ! 

3) Host mode password ... FPASSWORD 

4) DOS shell password ... SHELL 

Seeoutoobeud detect ....4. METHOD 2 

SeeCOnNnNection type.....s.. MODEM 
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FroaComm 2.4 The Setup Screen 


1) Host ID string 


The host ID string is a message that is sent to a remote caller when he 
cannects to FroComm in Host Mode. It can be set to anything you desire. 
Notice that the default message includes a CR translation character (here 
the "!'") at the end of the string. 


2?) Auto answer string 
The auto answer string can be thought of as a modem initialization string 
for use with the host mode. Use it to set the modem into auto answer 
mode. The default string is "°**¥+4+4+**%ATSO=1'", where 

we™ is al i/2 second pause 

tr+ gets the modem in command state 

we™~ 18 another 1 1/2 second pause 

AT is the command prefix 

50=1 sets the modem to answer after one ring 

' causes FroComm to send a CR. 
The "***" part is a FroComm command rather than a modem command and will 
probably not have to be reset. The other commands depend on the needs of 
your particular modem. Consult your modem user’s guide for further 
information. 
2) Host mode password 
FroaComm Host Mode provides some security by means of access passwords. 
The host mode password must be correctly entered by all remote callers 
before they are granted access to your system. The caller must match the 
password completely, including upper- and lower-case letters. If you set 
the password to mull, then callers can get through the password prompt by 
pressing “CRs without typing anything else. 
4) DOS shell password 
Callers must know this secondary password to be allowed access to the 
remote DOS shell. He very careful about this password; you do not want 
just anyone to have system-level access on your machine. You should 
definitely mot leave the DOS shell password blank, nor should you leave 
it at the default. 
2) Auto baud detect 


Auto baud detect allows FroComm to match the baud rate at which a user 
calls. 
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FroComm 2.4 The Setup Screen 


FreComm provides three choices of auto baud detect in host mode. The 
first choice is NONE, that is FProComm will not attempt to match baud 
rates with incoming calls. Users must call at the same rate that FroComm 
is set to in order to be connected. The second choice, called MODEM MSG, 
Uses modem messages to determine baud rate. Your modem must support the 
massages CONNECT (for 300 baud), CONNECT 1200 and CONNECT 2400 in order 
to use MODEM MSG. In addition, your modem must be configured to return 
these message. That configuration is usually achieved via the Kn modem 
command, which may be placed in either the modem initialization string, 
or the auto answer string. The third choice, known as FEY HIT, requires 
that callers enter several <CR?ts (or SFACES if at 2400 baud) in order for 
FroComm to match baud rates. No modem messages are required. FroComm 
defaults to FEY HIT. 


6) Connection type 

The connection type determines who FroComm Host Mode is talking to. When 
set to MODEM, FroComm assumes a modem connection and performs as 
described in the Host Mode section later in this manual. When set to 
DIRECT, FroComm bypasses the carrier detect process and immediately 


initiates a connection; this feature is useful for direct connecting to 
other computers. 


ASCIL Transfer Setup 


The ASCII Transfer SetUp Menu is used to determine the characteristics of 

file transfers in the ASCII mode: 

cece meen i + ASCII TRANSFER SETUP +-—---—---—--- nnn 
ASCII UFLOAD 


feeecnvo, Locally es.cc.. 46. .N0 
2) Expand blank lines ... YES 


Siorace character .ce..-. 0 (ASCII 
4) Character pacing ..... 15 (1/1000 sec) 
SPLINE PSGLNG «as « oe fee svn! (HALONsens 


Geer translation .«.a...) NONE 
Seer EP anSLabcion «.ss0.. STRIP 


ASCIT DOWNLOAD 


Goes tCranslatvon: «.% 5 = NOME 
eee translation «..0...«. NONE 


OFTION => SS erat 
ASCIT Upload 


h Echo bLocally 
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Use this setting to control whether or not FroComm echoes locally what it 
is transferring during ASCII uploads. In most cases set this to NO and 
let the remote do any desired echoing. If the remote and FroComm are 
both displaying what is being transferred, you'll have a real mess on 
your screen. 


<2) Expand blank lines 


Many systems interpret a blank line to mean "end of text". This is 
especially true when entering online messages. Use this aption to tell 
FroComm to expand blank lines. This would allow you to include blank 
lines (for spacing) in messages that you are uploading without the remote 
thinking it is the end of the message. When set ON, FroComm will add a 
Space to lines being uploaded that contain only a CR or CR/LF. When set 
OFF, lines are uploaded as they exist. By default FroComm will expand 
blank lines. 


=? Pace character 


The Face character provides one means of pacing uploaded text. If the 
pace character is set to a value other than OG, ProComm will send a line, 
then wait to receive the specified character before sending the next 
line. Enter the decimal value for the ASCII character desired; for 
example, set it to 12 to indicate a carriage return. FroComm will send a 
line and then wait to receive a CR from the remote before continuing to 
send the next line. The default is 6, which means that no pace character 
is uged. 


4) Character pacing 


Another pacing option that ProComm provides is character pacing. 
Specifying this option causes FroComm to pause after each character has 
been sent during an ASCII upload. This can help avoid over=-running the 
remote computer’s input buffer. If character pacing is set to a value 
other than 0, FProComm will send a character, then wait the specified 
number of milliseconds (1/1000 second) before sending another character. 
By default, character pacing is set at 15 ms. Character pacing may be 
used in conjunction with any of the other pacing options. 


2) Line pacing 


FroComm can also perform line pacing during ASCII uploads if you so 
desire. Line pacing is similar to character pacing except that the pause 
occurs after each line, rather than after each character. After a line 
is sent, the program will wait for the time specified (in 1/10 seconds) 
before sending the next line. Facing may be set to zero if the remote 
can handle that speed of transmission. Line pacing may be used in 
conjunction with character pacing; it is generally not needed if you are 
using a pace character. The FroComm default for line pacing is 10-tenths 
Of a second (i1.6., one full second). 


6) CR translation (uploads) 
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FraClomm 2.4 The Setup Screen 


As discussed above, different systems require different line end 
sequences. This option controls outgoing carriage return translation 
during an ASCII upload. You have 3 options. If CR translation is set to 
NONE, no translation is performed and carriage returns are passed 
directly to the remote. If set to STRIP, all carriage returns 
encountered in the file being uploaded are stripped, and not sent. 
Finally, if set to ADD LF, a line feed will be added to all outgoing 
carriage returns. FroComm defaults to NONE. 


7) LF translation (uploads) 


LF translation is similar to CR translation, but affects line feeds. As 
with CR translation, you have 3 options. If you select NONE, no 
translation is performed. If you set LF translation to STRIP, all line 
feeds encountered in the file being uploaded are stripped. [If you get it 
to ADD CR, a carriage return will precede all outgoing line feeds. The 
default for outgoing LF translation is STRIF. 


You should pay close attention to what is being done with these 
parameters. On a PC, most text files are delimited by a CR/LF Sequence. 
Most mainframe and other systems, however, want to receive ASCII files 
with only a CR as the delimiter. Thus the FroComm defaults take a file 
containing CR/LF sequences and transmit it as a CR-only delimited file. 
The various combinations available in FroComm will allow you to transfer 
ASCIT text files to virtually any system. 


ASCII Download 


8) CR translation 


The download CR translation is exactly like that described above io ss a 
applies to text going in the other direction; it translates CRs coming in 
to ProComm from the remote. There are three options for controlling 
inceming Carriage return translation during ASCII downloads. Me eS 
translation is set to NONE, no translation is performed. STRIF causes 
all carriage returns encountered in the file being received to be 
stripped, while ADD LF causes a line feed to be added to all incoming 
Carriage returns. The FroComm default is NONE. 


Fy LF translation 


This option controls incoming line feed translation during ASCII 
downloads. It also has 3 options. If it is set to NONE, no translation 
is performed. If it is set to STRIF, all line feeds encountered in the 
file being downloaded are stripped, and if it is set to ADD CR, a 
Carriage return will be added in front of all received line feeds. NONE 
is the default translation. 


Once again the variety of ASCII translation options will allow you to 
receive ASCII text files from any system in a format suitable for your 
PC. 
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FroComm 2.4 Major Functions 


4. MAT OR Be wee. Fe 


After the opening display and the program initialization, you are left in 
Terminal Mode. The bottom line of the screen is a status line, but the 
rest of the screen is open for use. Most of your cammunicating takes 
place in Terminal Mode, and most ProComm commands are executed from there 
as well. Commands are usually executed in a window which leaves your 
original screen intact. 


Commands are activated by pressing certain keystrokes while in Terminal 
Mode. You may, however, get a listing of available commands by pressing 
Alt-F1lO, the Help key. You can then execute commands directly from the 
Help Screen without returning to the Terminal Mode. Fressing any non- 
command key will return you to Terminal Mode. 


The Help Screen lists all of the major FroComm features, divided into 
three blocks: Major Functions, Utility Functions, and File Functions. 


Major Functions 


Dialing Directory 


Fressing Alt-D activates the dialing directory. The dialing directory is 
an online phone list which contains up to 100 entries and various 
information relating to those entries such as baud rate, parity, echo, 
etc. The functions available from the dialing directory are described in 
detail in Section &. 


Automatic Redial 


The automatic redial facility (accessed with Alt-FR) provides for 
automatic redialing of a single number or a list of numbers. Tt is 
especially useful for connecting to hard-to-reach numbers. Its features 
and how to use them are examined in Section 5. 


Keyboard Macros 


Reyboarcd macros allow you to assiqn character strings to the keys Alt-O 
through ALt-9, which may then be used to transmit the assigned string to 
the remote with a single keystroke. Macro strings may be up to So 
characters long, and may contain imbedded control codes and carriage 
returns using the translate conventions described in Section 3. To send 
the string you've assigned, simply press the appropriate key. 


Access the keyboard macro facility by pressing ALt-M from Terminal Mode 


or the Help Screen. A window will appear listing the current key 
assignments. To revise an assignment press "R", then the key to assign 
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FroComm 2.4 Major Functions 


(Alt-O through Alt-9). Now type the string you wish assigned to that 
key. Fress <CR?> when you are done. Respond "¥" to the ‘OR’ prompt to 
accept the assignment; otherwise, it 1s discarded. After creating a 
group of macros be sure to save them to disk, using the "S" option, or 
they will be discarded when you leave the current FroComm session. Fress 
LESC? to return to Terminal Mode. 


You may create and use any number of keyboard macro files for use with 
different systems. By default, FroComm will load the file called 
PROCOMNM.REY when it is brought up. To create other .KEY files, first 
select "C" (clear) to clear out the current macro definitions. Then use 
the "R" (revise) option as described above to create your new set of 
definitions. Now choose "S" to save the new definitions. When prompted 
for a file name, give the name of the file you wish the macro definitions 
to be saved in. The file may use any valid filename; we suggest using a 
file extension of .FEY to help distinguish the nature its contents. 
Fressing CR without naming a file will cause FroComm to store the macros 
in the default file FROCOMM.FEY. 


To load a new macro file select option "L" (load). Then give the name of 
the macro file to load. Again, if you press <CR? without maming a 
specific file, FroComm will use the default (PROCOMM.EFEY). The named 
file will be loaded and the new definitions displayed. Macro key files 
may also be loaded via the MLOAD script command. 


Multiple macro key files give you considerable flexibility in using 
different systems. One thing you can do is create different .FEY files 
for various systems that you call, then load the macros via a MLOAD 
command in a script file linked to that system in the dialing directory. 
If you use a consistent scheme (i.e. user ID in Alt-1, password in Alt-2) 
you can simplify many of your online tasks. 


Line Settings 


FroComm supports a wide variety of communications configurations. You 
may select baud rate, the number of data and stop bits, parity and 
duplex. The program defaults to 200 baud operation, with 8 data bits, 1 
stop bit, no parity and echo off (full duplex). 


Use the Alt-F command to review or change the active line control 
settings. After opening the Line Settings window, FroComm displays the 
current settings. Enter a number from 1 to 12 to change to a predefined 
setting. Use the numbers 13 through 19 to define a customized 
configuration. Enter 20 through 23 to make COM1 through COM4 your active 
port. 


The save option (24) is used to make the new configuration your default. 
If you change the line settings without saving them to disk, they will be 
used only for the current session. 


Press “ESC? to return to Terminal Mode, and the new settings will be in 
effect. 


Various systems have different line control needs. By far the most 
common settings are N/8/1 (no parity, 8 data bits and i stop bit) and 
E/7/1 (even parity, 7 data bits and 1 stop bit). Most bulletin board 
systems (BBS) require N/8/1. Many mainframe computers use E/7/1. When 
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FroCaomm 2. 4 Major Functions 


calling online services such as CompuServe and The Source via public 
networks like Telenet and Tymnet, be sure to use E/7/1. & good rule of 
thumb is if you are at N/8/1 and your screen displays a lot of garbage 
(graphics characters and the like), switch to E/7/1. 


An alternative to using E/7/1 on some systems is to use N/8/1 and strip 
the high bit off all incoming characters using the translate table. To 
do so, set the upper 128 (128-255) characters in the translate table to a 
Value exactly 128 less than their ASCII decimal values. Thus 128 would 
be set to 0, and 255 would be set to 127. 


Translate Table 


FroComm’s translate table provides a means for you to strip or replace 
unwanted characters you receive from the remote. Fress Alt-W to display 
the current translation settings. The table will indicate whether 
translation is currently taking place, as well as showing you the current 
translation values for the ASCII characters 0-127. PFress F2 to display 
translation values for characters 126-255. PFressing the keys F3 and F4 
will toggle the translation effect on or off. You may set the default 
condition from the General Setup screen in the Setup menu (Alt-S). 


To change a translation value, enter the decimal ASCII code to reset. 
Now enter the translated value (again in decimal). To strip an unwanted 
character, translate it to 0. For example, suppose the system you are 
calling sends a lot of beeps (ASCII 7) and you want to filter them out. 
Bring up the translate table (Alt-W). Enter a 7 at the ‘NUMBER TO 
CHANGE’ prompt, and then a © at the ‘NEW VALUE’ prompt. The change will 
be highlighted in the display. Now save the table by pressing Fi, and 
activate it by pressing FS. All beeps (ASCII 7) coming from the remote 
Will now be stripped out. Use the same technique to translate a given 
value to something else. Press <ESC? to return to Terminal Mode. 


One important note: when you turn the translate table ON, it reads the 
~ALT file from disk and overwrites the existing table. Thus you cannot 
make some changes, then turn on the table, since the changes you made 
will be overwritten. You must either make the changes, save the changes 
and then turn on the table, or turn on the table, and then make your 
changes. To make the changes effective for only the current session, do 
not save the changes to disk. 


Edwteor 


To call an editor, word processor or other program from within FroComm, 
press Alt-A. FroComm will then attempt to load the program you listed as 
the editor name in the General Setup portion of the Setup screen. You 
can specify any executable program (except batch files? to be called by 
the Alt-A command. This command is quite useful for viewing a file, 
doing some editing, or whatever. 


In order for this function to work, however, a couple of things must be 
correctly set. First, COMMAND.COM must reside on the drive you booted 
from. Second, ProCamm must be able to find the program you requested. 
(See the discussion on the editor name in the General Setup section). 
Third, your computer must have enough available memory to execute the 
desired program. There is no default for this feature, so be sure to set 
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FroComm 3. 4 Major Functions 
it up before attempting to use it. 


Exit 


To exit FroComm, press Alt-X. You will be asked to verify your decision 
to assure that you are not exiting by mistake. Answer "Y¥" to exit, "N" 
to continue working. Be sure that you have saved any setup changes you 
have made and wish to keep before exiting or they will be lost. 
Similarly, be sure you have completed your online tasks and signed off, 
since FroComm will hangup when you exit. 


Host Mode 


FroComm includes a limited Host Mode which allows remote access to your 
computer. You can activate the Host Mode by pressing Alt-C. Host mode 
features password protection, file transfers, operator page and DOS shell 
access. Tt can also display a canned message or graphics screen, and 
maintain a history of logons. Host Mode is described in detail in 
Section 8&8. 


Chat Mocde 


Chat Mode provides split screen operation for online conversations. 
Incoming text Cand echoed outgoing text if in full duplex) is displayed 
in the top 18 lines of the scereen. Outgoing text is displayed in the 
bottom 4 lines. 


Activate Chat Mode by pressing Alt-0O. Limited line editing is provided 
for outgoing text; use the backspace key to edit a line before it gets 
sent. Text is gent to the remote only after a carriage return or when 
the butter gets full Cabout 3 full lines of text). Ctrl-@ and Ctri-S 
keystrokes (XON and KOFF), however, are sent immediately. 


Printer and disk logging will continue if they are active when Chat Mode 
begins. The Redisplay facility (ALt-F6é) is also available in Chat Mode. 
Fress “ESC? to exit Chat Mode and return to the normal Terminal Mode. 


DOS Gateway 


FroComm provides a gateway to DOS which allows you to execute DOS 
commands or other programs without ending the FroComm session. Toa 
activate the DOS gateway press Alt-F4. FroComm uses the COMSFEC 
environment variable to find the command processor, 50 make sure that 
COMMAND. COM is present on the boot drive, or the gateway will not work 
correctly. Type "EXIT" on the DOS command line when you wish to return 
to FroComm. 


CAUTION: executing other communications programs through the Gateway may 
Cause erratic results when you return to FroComm. If this occurs, using 


the ALt-F command to reset FroComm’s line settings may re-establish the 
connection. 


Command Files 
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FroComm 2. 4 Major Functions 


Command files are text files containing FroComm commands. You can use 
command files to perform automatic logons, unattended file transfers, and 
many other tasks. You can create command files using virtually any word 
processor provided that the program can save files in a "non-document"-~ 
or straight ASCII-~~-format. Command files may be executed on program 
startup, from the command file menu (Alt-FS), or by linking them with 
dialing directory entries. See Section 7 for a complete discussion of 
command files and the FroComm command set. 


Recdisplay 


To redisplay lines that have scrolled off your screen, press Alt-Fé4. 
FroComm will display the last 10000 characters that have come in, 
beginning with the most recent screen. 


You can move through the redisplay buffer in any of several ways: use 
the PgUp and FgDn keys to scroll one page in @ither direction; use the up 
and down arrow keys to move one line in either direction. Pressing the 
Home key will cause the first page of the buffer to display, while 
pressing the End key will display the last page. To search for specific 
text with the redisplay buffer, press "F" or "/". A window will open, 
and you will be prompted for the string to search for. If the string is 
found, FroComm will scroll to the page it is on and highlight it. To 
search for the same string again, press <CR? when FroComm prompts you for 
the text to look for. Searches are not case sensitive. 


Utility Functions 


Program Information 

To display the FroComm program information screen, press Alt-1I. Type any 
key to return to Terminal Mode. 

Setup Screen 

Use the SetUp option (Alt-S) to access the 6 setup areas: modem setup, 
terminal setup, Eermit setup, general setup, host mode setup, and ASCII 
file transfer setup. These options are described in detail in Section 3. 
Kermit Server Command 

ProComm provides several Kermit server commands for use with remote 
systems running in Kermit server mode. Access the command menu by 


pressing Alt-E, then select the desired command from the menu. See 
section 6 for more details regarding these commands. 


Change Directory 
You can use the ALt-B command to change the default directory and/or the 


active drive. To change directories, press Alt-B. A window will appear 
naming the current drive and directory. Simply enter the drive 
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FroComm 2. 4 Major Functions 


{including a colon), directory or both and press «CR. You have now 
changed the default drive and or directory. Fress <ESC> to leave the 
default unchanged. 


Clear Screen 


Frese Alt-C to clear your screen and home the cursor. This is a local 
effect only. Clearing the screen will also reset FroComm to its default 
ceolors, useful when connecting to systems which change colors and don‘t 
reset them. 


Toggle Duplex 


Pressing ALt-E will toggle FroComm between full and half duplex. You can 
set the default duplex in FroComm’s SetUp (Alt-S) screen. Tf characters 
you type appear twice (te.g., "AAppeeaarr TTwwiiccee") you should set 
duplex to full. Similarly, if you type something that is not displayed, 
but should be, try toggling duplex to half. A message is briefly 
displayed on the status line, and the duplex block (the third block on 
the status line) indicates whether you are currently operating under half 
Wr duplex ("HDX cor “FDX"). 


Hang Up Fhone 


Press Alt-H to hang-up your telephone connection. ProComm will first 
attempt to hangup by dropping DTR (Data Terminal Ready). Tf this attempt 
fails, as indicated by the presence of CD, then the modem hang-up string 
will be sent to the modem. If FroComm is not causing your modem to hang 
up correctly, be sure that your modem does not have DTR or CD forced 
high, and check the hang-up string in the modem SetUp screen (via Alt-S?) 
against the string suggested by your modem user's quide. 


Elapsed Time 


Pressing AlLt-T will display the current time and date, as well as the 
elapsed time since the last call was made. Elapsed time is reset every 
time you make a call using the dialing directory or make a connection 
using the automatic redial facility. 


Frint On/O+¢ 


Press Alt-L. to toggle printer logging on or off. If printer logging is 
toggled on, any information coming from the remote system will be sent 
directly to your printer as well as to your screen. The status of the 
printer log is indicated by the message FRT ON or FRT OFF on the status 
line. 


Set Colors 


Enter A@lt-Z from Terminal Mode to set your local screen colors. A windaw 
“will open with a list of window selections on the left and instructions 


on the right. Fress the up or down arrow keys to select a window to 
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change. Next, press the left or right arrow keys to choose which part of 
the window to change (background, foreground, or hi-light). Fress the 
space bar to cycle among the color choices. After you have set all the 
colors you want to change, press <ESC> to exit. You will then be asked 
if you want to save the color changes to disk. If you save the changes 
to disk, they will remain until you change them again; otherwise they 
will remain only for the current session. You can use this last option 
to set the colors temporarily, try them out during a session, then return 
ta Alt-Z and save them to disk. 


Some windows do not appear in the window list but are settable anyway. 
The ALt-T (elapsed time), Alt-B (change directory), amd ALt-X (exit) 
Windows use the same colors as the keyboard macros window. The redial 
display (Alt-R) uses the phone directory (Alt-D) colors. The SetUp 
screens (Alt-S) use the help window colors. Communication screen colors 
are used in the redisplay section and the command file selection window 
(Alt-FS) uses the file transfer window colors. 


Auto Answer 


You may control the auto answer feature of most modems using a software 
command. For instance, sending the command "ATSO=1<CR>" to a Hayes modem 
tells it to answer the phone on the first ring. Similarly, the command 
"ATSO=O0<CRe" tells that modem to turn auto answer off. 


FroComm allows you to issue an auto answer command at the touch of a 
keystroke. Fressing Alt-Y causes the string you have specified as the 
auto answer string in the Host Mode section of the SetUp screen to be 
sent to the modem. Note that this command is used to set the modem into 
auto answer mode; it is not used to command the modem to answer 
immediately. You could use a command such as "ATA!" in a keyboard macrea 
to instruct the modem to answer on command. See Sections 3 and 8 for 
more information regarding the auto answer string. 


teegies CR = CR/LE 


Some remote systems delimit lines of text with a single carriage return, 
while others use a carriage return/line feed combination. FroComm likes 
to receive lines that end with both a CR and a LF. If necessary, FroComm 
can add a line feed to each incoming carriage return. 


Use Alt-F3 to toggle this feature between CR and CR/LF. The default is 
CR only, that is, do not add additional LFs. If text lines overwrite 
each other, the remote is not sending LFs, so switch to CR/LF. FF ext 
appears double spaced, try the CR setting. A message is briefly 
displayed when you toggle this option, and the current setting is 
reflected in the next-to-last block of the status line. The default 
candition far this option may be set in the Terminal Setup section of the 
Setup facility. 


Break 
A break 15 a spacing condition on the line, often used to signal 


attention to the remote. Fressing CTRL-BREAK will cause the break 
condition to occur. On some non-IBM machines pressing CTRL-BREAR can 
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cause a lockup; therefore FProComm provides another keystroke, ALt-F7, 
which also causes the break condition to occur. The default time period 
for a break is 250 milliseconds, but that may be changed via the Terminal 
SetUp screen. Use the keyboard macro feature if you require that a 
specific character be sent in order for the remote to realize a break. 


File Functions 


Send Files (Upload) 


FProComm provides a number of common protocols for use transferring files; 
pressing FqUp will activate the screen listing those protocols and allow 
you to choose among them. See Section 6 for a detailed description of 
file transfers. 


Receive Files (Download) 


Fressing FqDn activates the download menu screen and allows you to select 
from the available protocols. See Section 6 for more details on file 
transfers. 


Directory 


Frese ALt-F to get a file listing of the currently logged drive or 
directory. Enter the file specification ("filespec") at the prompt just 
as you would im the BOS DIF command. Faths and drives are supported. 
COMSFEC must be set correctly for this feature to work. That 15, you 
must have COMMAND.COM on the boot drive, or the ALt-F command will not 
work correctly. 


View a File 


To @xamine a file that @xists on your system type ALt-V. You will be 
prompted for the name of the file. Enter the complete filename, 
including drive and path designator if desired. Use the FqaUip and FgDn 
keys to page through the file. Fress Home to go to the beginning of the 
file. Fressing «ESC? will end the viewing procedure and return to the 
Terminal Mode. This viewing facility is rather primitive; it is intended 
only aS a convenience. For more complete browsing power, use the ALt-A 
editor command, or drop through the DOS gateway and use your favorite 
list program. 


Screen Dump 
Pressing Alt-G activates a screen dump of the current screen contents. 
Screen contents are appended to the current .IMG file, which may be 


specified in the SetUp screen. The default screen dump file is 
FROCOMM. IMG. 


Lag Toggle / Log Hold 
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FroComm 2.4 Major Functions 


FroComm provides two alternatives to file transfer for capturing 

) information: file and printer logging. After initiating the logging 
procedure, any information coming from the remote system is routed to the 
log as well as to the screen. 


Press Alt-L to begin capturing information to Your printer, A Message 
on the status line will indicate that the printer log is open. Fressing 
Alt-L. again will toggle printer logging off. 


FroComm writes the logged data to the DOS device PRN. The default value 
for PRN is LPTis. You may use the DOS ‘MODE’ command to redirect PRA. 
For example, if your printer is on COMi: use the BOS command 


MODE LPTis=COMIis 
to send printer output there. 


Data can also be captured to disk, using the ALt-Fi command. Specify 
the name of the file to be used, or press <CR? to use the default file. 
If the file already exists, new information will be appended at the end 
Of the file. Fress Alt-F2 (Log Hold) to suspend information capture 
without closing the log file. A message indicating logging status will 
be displayed on the bottom line of the screen. Fress G1lt-Fi again to 
toggle the log file closed. 


With the exception of formfeeds, terminal control Sequences are not 
included in the log files. 
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ProComm 2.4 Dialing Directory 


Sd aed feel. SE rN et Dl Gi Ee ch tap OF cite: 


The FroComm dialing directory automates most of your dialing tasks. The 
directory holds information for 100 of your most often-called systems. 
The information includes the name and phone number, as well the 
communications parameters specific to that entry. Also included in the 
directory is a user definable modem command, with an optional suffix, and 
up to four long distance codes that you can use with alternate 
long-distance services. You can even link command files to dialing 
directory entries to provide custom setup configurations or to perform 
logon sequences automatically. 


Fress Alt-D to access the dialing directory. A window 1s opened that 
displays pages of 10 entries at a time: 


feminine TY T AL IN G EER NT St Spe ANG EU BEIM NR NS a ed ah eae aca 
i Name Nuumbs er Baud Fob SS ce CMD UPrle 4 
i 1 
| i- ProComm Support BES 1 314 449-9401 24600-N-8-1 WN i 
ee ee ot Se ed ah So kd ce at aha s os ot h2OOrN- 8-71 «(iN i 
A ahd oo eslshe Gree een 2 evade ail seals Be eoetee ake t 1200-N-S-1,' N 
ei ei ase eke + a lele, aie luintaca gaya Mel y's eke Balle oe Dase sis PeZCG-Nah=at «iN i 
era ye Pics: SoS SR Mh aLehe Sl SLaehe | ats ae e 6s 1{200-N-8-1 oN i 
ee ole chal sls doatwia Sie¥a Saye ehaters Ua) eee alibers aot a caars, 2200-N-S—) oN H 
1 ES re ra ae ee ae ee £200-N-e-—-71 ON i 
OMe ialis nie eos © Foal a a eon em Aen ek See ee t200-N-S—) MN i 
ee aia 5 Ma eiels wel s Sale ale os PN ita) CRP emtae ar L200-N-G-—1 N i 
Fark a ws ae he 6 oe Ae oe yp ee RC a ee ee 1200-N-8-1 WN i 
i i 
i ==> FR Revise M Manual Dialing Entry to Dial i 
H FP LD Codes D Delete Entries Boehime i 
i PgUp/FgDn Fage kyPrantaEntries A eoeeroll i 
i Home Top Fage End Bottom Fage BSC oe 1't i 
i Modem Dial Cmd:s ATDT LD Codes Actives i 
i Dial Cmd Suffix: - Com Fort Actives COMI i 
“j- ery crs eacest ga cntss econ ruse saves acenr sevus sense leveey gists Actes onsin aves pasny sopevlquste'oesea sooth pest onan sunet witey rane] asose ovvee shee ress east Sean] eoned| ooses teen ones sites nnéns ants axens/ nome stwow Snows abey icbfa <tsed wies,ovees'emce crews oabey entes ccnts|sstee| mbes sewev eters, eveen:eeeen. tetey, subs inecee Dente eupee evees wets w oo 


The current modem command ("Modem Dial Cmd"), modem command suffix ("Dial 
Cmd Suffix"), active long distance codes ("LD Codes Active") and the 
active port ("Com Port Active") are displayed at the bottom of the 
screen. The modem command defaults to "ATDT", with "!" (translated as a 
CR) as the suffix. 


Use the FgUp and FgDn keys to display the previous or next page of 
entries. The up and down arrow keys will scroll the display one entry in 
either direction. The Home key will position the display at the first 
page in the directory, while the End key will position it at the last 
page. Fress <ESC? to exit the dialing directory. 
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FraComm 2. Dialing Directory 


searching for an Entry 


The dialing directory also has a search capability. To look for a 
particular entry press "F" or "/". A window will open asking for the 
text to search for. Enter the string you wish to be found and press 
SCRe. FroComm will search the name and number fields for the string you 
provided. If the string is found, the dialing directory will scroll to 
the page containing that entry, and the entry will be highlighted. 


The dialing directory search facility is not case sensitive. For 
example, a search for.the string "abcd" will match "abed", "ABCD", “AbCd" 
or any other mix of upper and lower-case characters. You can even 
search for telephone numbers or even parts of numbers. (That 168, you can 
search for "Phil Sidney", just "Sidney", or "555-1586", or even "1586".) 
If the search routine reaches the end of the dialing directory without 
finding a match, it will wrap around to the beginning of the directory 
and continue its search until it has checked each entry once. Tf the 
string is still not found, a message to that effect is displayed. To 
repeat a search for the same text, press "F" or "/" a second time and 
then immediately press <CR:. 


Revising the Dialing Directory 


When you first use the dialing directory most of the entries will be 
empty. The name and phone number fields will be filled with periods; the 
default baud rate is 1200, with no parity, 8 data bits, 1 stop bit and 
echo off (full duplex). You may add a new entry or revise an old one by 
selecting the "R" option. You may also revise the long distance codes 
(by entering the appropriate LD code identifier: -,+,@,#). An entry need 
not be displayed on the screen in order to revise it. 


Adding or Revising an Entry 


To add an entry to the directory, or to change an existing entry, enter 
"RY at the "==>" prompt. A window will open and you will be asked for 
the entry to revise. Type the entry number (1-100) you wish to revise. 
The current values for that entry are displayed at the top of the window. 
You are prompted first for the name. Fress <CR> to retain the current 
Value, or enter up to 24 characters for a new or revised name. You can 
use the backspace and left arrow keys to edit your entry. Press <¢CR> 
when you are done. You will now be prompted for the phone number. Enter 
only the numbers you n@éed; the number will be right justified on the 
page. For example, if you are entering a local number, you need not 
enter spaces for the area code. Fress <CR> when you are finished 
entering the number. 


The current baud rate will now be displayed. Press any key (except <ESC> 
or <CR?) to cycle through the available baud rates. Fress <CR> to select 
the one you want. Use the same technique to select the parity, data 
bits, stop bits and echo. You will now be prompted for a command file to 
link to the entry. Enter the filename without an extension or path. The 
same command file may be linked to any number of dialing directory 
entries. To clear an existing command file, type a space and then <CR?. 
If you don’t want to link a command file with this entry, then press <CR> 
without specifying a filename. 
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Froalammn 2.4 Dialing Directory 


After specifying the command file, you will be asked whether to save the 
entry to disk. Enter "Y" to save your changes, "N" to abandon them. You 
may also abandon a revision at any point by pressing “ESC?. Tf you elect 
to save the entry, it will be written to disk, then the current page is 
redisplayed, reflecting the changes you have just made. Lp oot Cre TNT, 
save the entry to disk, all your changes will be lost. 


Revising the Modem Command 


The modem dialing command, and its suffix, are settable in the Modem 
SetUp section of the SetUp command. 


Adding or Revising Long Distance Codes 


Long distance codes are used primarily for accessing alternate 
long-distance services. Four such codes are provided, identified by the 
Peer acters t=", "+, "4" and "#". Enter "FP" vat the dialing directory 
tee" prampt to display a window containing the current long distance 
cade definitions. Fress any key to remove this window from the screen. 


To revise a long distance code, enter the "R" command. Now enter the 
long distance code id character at the “Entry to revise" prompt. The 
current string for that long distance code will be displayed, and you 
will be asked for the mew value. Control characters and carriage returns 
may be included in long distance codes by using translation conventions 
described earlier. Fress <CR?> to complete the long distance code 
revision.  FPressing <CR> as the first character in the new string deletes 
that long distance code. If you do not save the changes to disk, they 
will be in effect for the current session only. Fress “ESC? to abandon 
long distance code changes completely. 


Lang distance codes are used to provide access to alternate long distance 
carriers, to dial through office FBX or switchboard equipment, or for 
Similar uses. Long distance codes may precede or follow the number in 
the dialing directory entry. For example, say you wish to call some long 
distance number using your Sprint account. KHegin by setting up a long 
distance code. Choose "RR" to revise, then select the ld code to change 
ee tee 9H). 6G the "4" ld code to “125-4567,,,979999," where “123- 
4567" is your local Sprint telephone mumber, and "99999" is your Sprint 
account ID (tor password). Ta dial an entry, say number 14, using Sprint, 
enter "#i4" at the "==>" prompt. This i6 what happens: the modem will 
dial the local Sprint number, wait six seconds (the comma is a Hayes 
modem command convention for a two second delay) then enter your Sprint 
access code. It then waits another = seconds (the final comma) then 
dials whatever happens to be specified in entry number 14. Similar tasks 
can be performed using different ld codes. And remember, each code may 
be placed Sither before (i.e. "#14"), after (i.e. "“LT4#">) or both before 
and after the entry to be dialed. 


Deleting Entries 
You can use the “D’ command to delete entries from your dialing 


directory. & window will open and prompt you for a range of entries ta 
delete. Enter the starting and ending entry numbers for the range you 
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FroComm 2. 4 Dialing Directory 


wish to delete. Leave the second field blank to delete a single entry. 


For example, to delete entries 15-25, enter "1S" in the first space and 
N25" in the second. After verification, those 11 entries will be 
deleted. To delete just entry 37, enter "37" in the first space, and 
press <CR> in the second. You'll be asked to verify that you actually 
want the entries deleted before any action is taken. 


Making a Call 


To dial an entry in your dialing directory, simply type the entry number 
(1-100) at the "==>" prompt. To dial with a long distance code, place 
the code’s identifier before and/or after the entry number. For example, 
enter "14" to dial entry number 14. Enter "#14" to dial entry number 14 
preceded by the long distance code identified by "#". Enter "14+" ta 
dial entry number 14 followed by the ‘+° long distance code. FroComm 
will send the modem command, an optional long distance prefix, the 
number, am optional long distance code, and finally the modem command 
suffix to the modem. All five parts of the dialing string are translated 
using the conventions described earlier under string translation (see 
Section 2). The parameters for the dialed entry become the current 
settings and remain after the call is complete. 


If a command file is linked to the entry being dialed, the redial 
facility will be used to place the call. When a connection is made, 
control is passed to the linked command file. Command files can be very 
useful for setting up custom terminal configurations, performing 
automatic logons, loading specific keyboard macro files and many other 
functions. 


Manual Dialing 


To dial a number not in your directory, enter the manual dialing command 
('M") at the "=="" prompt. Then enter the telephone number you wish to 
dial. FroComm will send the dialing command plus the string you entered, 
plus the modem command suffix. A long distance code indicator may be 
used if it is the first and/or last character in the string (that is, you 
can enter "4+212-555-1552", "S12-555-1552#" or "+212-S555-15524"). 


Printing the Directory 


FroComm lets you output your directory to a printer, disk file or any DOS 
device. Type "L" at the "==>" prompt, then specify where to send the 
file. Simply press <CR® to use the default of PRN. You can even Output 
the directory to the COM port you are using and send a listing of your 
directory to the remote computer. 


Automatic Redial with Circular Dialing Queue 


Some remote systems can be very hard to reach. FroComm makes it easier 
to access hard-to-reach systems with its automatic redial feature. Fress 
G@lt-R to invoke the redial procedure. When the redial window opens, 
specify one or more dialing directory entries separated by blanks, commas 
or semicolons. Entries may contain long distance codes. FroComm will 
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FroaComm 2. 4 Dialing Directory 


cantinuously redial the numbers in the list until you are connected. 
Fressing <CR> without specifying any entries will cause FroComm to dial 
the numbers that were in the list the last time it was used. 


If the redial time is exceeded, or FroComm senses one of the modem’s no 
connect strings (specified in the SetUp screen), the program will 
automatically move to the next number in the list. As Bach number is 
reached, it is removed from the circular queue. To remove an entry that 
is being called from the list without first connecting, press the Del key 
while that number is -being dialed. You can also press the Space key to 
abort the current call and proceed to the next entry in the list. 


Set the length of time FroComm waits for some response by pressing the 
End key; specify the new time to wait (from 3S to 100 seconds) and press 
2 ae If you want this change to become permanent, respond "Y¥" to the 
"save to disk?" prompt. Be certain, however, that the your modem’s delay 
timeout is set at least as high as the wait time you specify here; 
otherwise, the modem will timeout and disconnect before the redial wait 
time is reached. You can specify the redial timeout delay in the Setup 


(Alt-S) screen as well as at the redial function. 


Between calls FroComm will delay for the amount of time specified by the 
modem pause delay parameter (see Section 3). This delay is provided toa 
allow the modem sufficient time to reset between calls. To continue 
immediately with the next call, press the Space key. 


The alarm will sound when you connect during a redial. If a command file 
is linked to the entry that has connected, program control will pass to 
the linked command file. Command returns to you when that command file 
has finished its tasks. 


Copyright (C) 1986 Datastorm Technologies, Inc. eee ba 


pbk te sl. ane GT ae aNd . Sida wv 
y t : ¥ a 7 , he 

i 
.betsennaa a6 ey fitai seit ond 


fatbh oF modo Ss seuss Likw aar ne a 
beau Qow tt emit Sipe! ls 


on @' asbom add i and @sene2 mmole 
Litw mé4oosg seria, (ves 358 2232 9 Be 

ei rednun doen aA .telf etitoni ,edmun Be: 
18407 vadns 16 Sevones at -evuaup %elustin ati 
yau let ant agesa ,enitvennon saat? Inadtiw Fare 


62 you ege ans a2805q ols naa wey ~. beled see at “ye cla a 
‘Juit anid at yuina tren sat of bassa 7d bie tins A090" 


= 


ant pnLeesarq vd Senoges4 emie 70% 2% lew mmoJent le He itoned 
aeeo bons (ebnosse OO] oF SC mon?) tlew of Smra wen adds iz2eqgs 

eis oF "Y" Enogee «iosinwa, ssosed ooiepneia aiid toew Woy z 

yealeb e° mekawm evoy ent Jans, Sevewod nis a3 ell -dqmang, \iotersh 

g27el yiraqe voy site Siew odd ee Hein ae Jeass) te tee « 

tisw Jere ant syoted Jsannagatb lone Sisceeon lt Li tw yee ay art, 

“seas aiaont yeleb guoemis tatben orlty 3? page neo Boy aberos a 

noisenm? isibas endage as i few an nag sz 

ny yd beitioese emis do Jnuume BAX Aor ve lab iLiw maton 2d hm 

ot bebivow, #2; pieb waril Wf Cakt2e? eee) Seles ng Yeleb 

sn i eet -@lisa seeawted teea" of emtze Jnainiviur fyaebicymn = 

-YSu eneqe adit anew + Lian teen ead teiw vi 

amnmie> 4 lath ® enrweo gasnreas sai oriy bewne ch ie m 

, Baad i nos me syvorNg ~betasnnc2a 2am tans yo fe ant oF 

i} | mon teat on iOoy oF eosides bosemeed alt bremmes, he 

—tHaad e26 bets 


4 


FroCamm =. 4 File Transfer 


Getty ed LE Tih AY NS Or ME RR 


The ability to transfer information makes a communications program a very 
powerful tool. FroComm gives you several choices for two-way information 
transfer via file transfer protocols. With them you can upload (send) 
and download (receive) files from almost any system. 


Uploading Files 


Begin a file upload to another system by starting the transter on the 
remote computer. When the remote indicates that it is ready, press FgUp. 
You will be presented with a menu of protocol choices: 


femme URL OAD +--+ 
ibe XMODEM 
a) Kermit 
any, Telink 


4) MODEM? 

3) YMODEM 

SP °VYHODEMN Batch 
7¥O, ABET] 


3 COMPUSERVE & 
9) WAMODEM 
ESC to Abort 


if A cellgas Kos ipesins (etna = [SO WIm <etgn, “ivebaae Leelee) (Gen 06S) ieee cease! “ativer 


FRovocoil: i 


Enter the number of the protocol you wish to use. A second window will 
prompt you for the name of the file to upload. Enter the tilename, 
including a path if you wish, then press <CR>. Another window will open 
and report on the progress of the transfer. 


An ASCII upload is something of a special case. No transfer progress 
window will be displayed, but the status line will indicate that an ASCIT 
transfer is taking place. ASCII uploads are under the control of several 
setup options. The first set of options control pacing. You can set 
FroComm to pause after it sends each line of text or after each character 
to avoid overflowing the receiver. You may also set FroComm to wait to 
receive a specific character before sending the next line. Another 
option allows you to specify if text is to be echoed locally. In most 
cases you will want to let the remote do any echoing of transferred text. 
Still other options determine whether carriage returns or lineteeds 
should be stripped or translated from the outgoing file. 


Downloading Files 


Downloading files is just as easy. After starting the download procedure 
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FroComm 3. 4 File Transfer 


on the remote, press FgDn. The protocol selection window is again 
displayed (but this time headed "DOWNLOAD"). Enter the number of the 
protocol you wish to use. If a Default Download Fath has been specified 
in the General SetUp area, downloaded files will be placed in the 
specified directory. Otherwise they will be placed in the currently 
logged drive and directory. 


If you select ASCII, XMODEM or YMODEM protocol, a window will open and 
you will be prompted for the filename. In all other cases the filename 
is provided by the sender and you do not need to enter it locally. If 
you enter the name of a file that already exists you will be asked if it 
should be overwritten. If a filename provided by the sender already 
exists, the received file will be renamed by placing a dollar sign in the 
first position of the filename. For example, if you select toa download 
FILEL.EXE using the Telink protocol and that file already exists, the 
downloaded file will be named #ILE1.EXE. 


After you have specified the protocol and (possibly) the file name, a 
window will open which displays information regarding the transfer. When 
the transfer is complete, or an abort is sensed, the alarm will sound and 
appropriate messages will be displayed. 


ASCII downloads are somewhat different from the others in two respects. 
First, no transfer status window is displayed. A message on the status 
line indicates that an ASCII download is in effect. Second, ASCIT 
downloads need user intervention to complete. Text will continue to be 
captured until you press <ESC?> to terminate the transfer. 


There is, however, a large degree of control over various ASCII file 
transfer parameters. These can be set from the SetUp screen (Alt-S). 
You can conform CR and LF translation in a number of ways, allowing 
transfer to or from almost any system. 


File Transfer Frotocols 
There are nine file transfer protocols available in FroComm: 


ASCII 


ASCII file transfer is the equivalent of typing information from one 
system to another. The ASCII characters are sent in a one-way stream 
with no handshaking (other than XON/XOFF, if it is activated) or error 
checking performed. This method is fine for some applications, but you 
are limited to text file transfer. 


One difference between an ASCII download and file logging is that all 
data (including terminal escape sequences) is captured, while during 
logging terminal control sequences (with the exception of formfeeds) are 
filtered out. 


FroComm provides a number of ASCII file transfer settings which allow you 


to transfer data to or from most any system. These options are settable 
Via the ASCII Transfer SetUp section of the SetUp facility. 
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FroComm 2. 4 File Transfer 


KXMODEM File Transfer 


XMODEM is a block-oriented error checking protocol released into the 
public domain by its creator, Ward Christensen. It is very popular on 
@lectronic bulletin board systems. XMODEM transfers only a single file 
at a time. The protocol uses two-way communications and either a 
checksum or cyclic redundancy check for error checking. XMODEM can 
handle text or executable files with over 99% accuracy. FroComm supports 
and automatically adjusts for both the checksum and CRC variants. 


The XMODEM protocol is defined such that CRC checking is always attempted 
first. Tf CRO is not acknowledged by the sender then the checksum method 
is used. While FroComm correctly implements this system, however, some 
other systems do not. As a result, a problem can arise if the remote 
system responds to the CRC attempt but uses checksums. 


Note that XMODEM requires transfers to be performed with 8 data bits, 1 
stop bit and no parity. If you attempt to begin an XMODEM transfer while 
set to other parameters, FroComm will automatically switch to N/8/1, 
returning you to your original parameters when the transfer is complete. 


some systems, such as CompuServe, have trouble meeting the standard 
AMODEM timing sequences. You may set FroComm’s XMODEM facility into a 
"relaxed" mode, which has less critical timing, using the SetUp (Alt-S) 
screen. Most other systems, however, will work fine with XMODEM set to 
normal. 


MODEM? File Transfers 


MODEM7 is a variant of the XMODEM protocol. By sending the filename, 
batch transfers (multiple files) can be accomplished. CRC and checksum 
are supported. 


YHODEM File Transfers 


YMODEM is another XMODEM variant. Its main advantage is that it supports 
longer data blocks (1E) and thus speeds transfer times. FroComm supports 
YMODEM for single file transfers and YMODEM Batch for multiple file 
transfers.  YMODEM Batch also provides some header information, such as 
filename and filesize. YMODEM file transfers are always performed with 
CRC error checking. 


Telink File Transfers 

Telink 16 yet another XMODEM/MODEM?7 variant which adds file size and 
creation date information. Tt is found mainly on FIDO bulletin board 
systems, and provides for batch file transfers. 

Kermit File Transfer 

Rermit is a packet-oriented protocol developed at Columbia University and 
is available on many different computer systems. By using a technique 


called Sth-bit quoting, Fermit is able to transfer binary files between 7 
and 8 bit systems. In some implementations, such as FProComm, Fermit 
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FroComm 2.4 File Transfer 


supports multiple file transfers. 


FroaComm’s implementation of Kermit includes all of the latest Kermit 
enhancements, including data compression, file attributes, and sliding 
windows. 


The most significant of these features is sliding windows. A "sliding 
window" protocol is a full duplex protocol that can transmit and receive 
data at the same time. The XMODEM family of protocols are half duplex 
protocols. They must wait between each block of data for a reply from 
the other side. XMODEM wastes quite a bit of time this way. Full duplex 
protocols can send a continuous stream of data while receiving replies at 
the same time, thus greatly increasing file transfer efficiency. FroComm 
Eermit will automatically sense if the other Kermit supports sliding 
Windows and will use them if it does. Currently, Sliding Window Kermit 
is available on The Source, TCOMM BBS, and FPC-HOST BES. Mainframe 
versions are under development and should be appearing soon. FroComm 
hermit is backward-compatible with earlier versions of Kermit. 


FroComm’s default Kermit settings are fairly standard and should need to 
be changed only under special conditions. Because of the sliding window 
enhancement, block size should be limited to a maximum of 96, rather than 
94 as in standard Kermit. 


In addition, a few Kermit server commands are supported. Frese ALt-E to 
access the Kermit server command menu. Available commands include 
Finish, Logout, Send and Get. Get (option 1) and Send (option 2) will 
both prompt you for the appropriate filename and then perform the 
indicated function, i.e. @ither GET (receive) or SEND (transmit) a file. 
Finish (option 3) will terminate the Kermit session and return you to the 
system level. Logout (option 4) will terminate Kermit and log you off 
the remote. These commands are effective only when the remote Kermit is 
operating in server mode. 


More information on Fermit is available from Columbia University. Send 
#5 each for the Frotocol or User manual to: 


Kermit Distribution 
Columbia University Center for Computing Activities 
7th floor, Watson Laboratories 
612 West llSth Street 


bigs = 


New York, NY 1002S 


CompuBerve B File Transfers 


The CompuServe B protocol is available on the CompuServe Information 
Service. Tt may be used with FroComm in two ways. You may select it 
from the Upload or Download selection windows like any other protocol. 
You may also operate it in an automatic mode. To do so, set the ENG 
parameter in the Terminal SetUp section to CIS B. This activates the 
automatic capabilities of FroComm to handle CompuServe B file transfers. 
All you need do at that point is instruct CIS to begin a transfer, and 
let the software do the rest. He sure not to set ENG to CIS B unless you 
are connecting to CompuServe or strange results may occur. 


WKXMODEM File Transfers 
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FroaComm 2.4 


WXMODEM, 


Feoplelink online service; 


another variant of the XMODEM protocol, 


toa that discussed under "Kermit File Transfer", 
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Command files are text files you create that contain FroComm commands. 
You can use command files to perform automatic logons, perform unattended 
file transfers and many other tasks. You can even link command files to 
the entries in your dialing directory so that the entire dialing and 
logon procedure is automated. 


You can create a command file using virtually any word processor which 
saves in straight ASCII format; if your word processor normally makes use 
of special or extended ASCII characters, then you should use its 
"non-document” mode. A command file may have any valid filename; 
however, FroComm looks for files with an extension of .CMD when it lists 
available command files. 


Command files can be executed from within FroComm or as a command line 
option when you first invoke the program. If you specify them on the 
command line, using the "/F" option, they will be executed immediately 
upon program startup. Execute them from inside the program by pressing 
Alt-FS. FroComm first searches the current directory for files with the 
~CMD extension. If any are found, their names are displayed in the 
window. If none are found, FroComm will look in the directory pointed to 
by the FroComm environment variable. Again, the names of any files found 
are displayed in the window. If no files are found in @ither directory, 
the message "NO FILES" will be displayed. 


To execute a command file you may either type the filename or choose from 
the scrolling window display of available .CMD files. If you type the 
filename, you may omit the .CMD extension. To choose from the scrolling 
window, position the highlight on the name of the file you wish to 
execute and press <CR. PqUp and PgDn will scroll the window one page in 
either direction. The arrow keys will scroll the window one entry in 
either direction. Fressing the Home key will position the list at the 
first page of available command files; pressing End will position it at 
the last. If you don’t see the highlighted entry, use the Ait-Z command 
to change the color being used for highlighting so that it is different 
than that being used for regular foreground display. The command tile 


~~ 


window uses the colors displayed in Alt-Z for the file transfer window. 


Once you begin to enter a command file name at the prompt you may still 
scroll the window, but you may not select a file for execution from the 
scrolling display. 


Abort a command file by pressing “ESC? during its execution. The command 
file will abort when the current command has completed (which might take 
a few seconds). In some cases, such as while dialing or performing a 
file transfer, two “ESC ?‘s are needed: one to abort the task in progress 
and a second to abort the command file. 


There is a special command file named FROFILE.CMD which FroComm looks for 
in the default directory first, then in the directory pointed to by the 


si 
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ProComm 2.4 Command Files 


FroComm environment variable (see Section 1). Pi rho Ce Ch VS. Pound, 
it will be executed immediately upon program startup, before any other 
command file specified as a "/F" command line option. . You can use the 
profile to do such custom setup work as changing to a special directory, 
turning off the sound, changing line settings, or overriding the default 
modem initialization string. 


Command File Syntax 

Command file commands begin with special command words, listed below. 
Commands may be entered in either upper- or lower-case. When processing 
commands FroCamm looks only at the first 4 characters. Thus all the 


following commands are treated the same: 


TRANSMIT = trans = Tran = TRANSM 


i 


Each command must appear on a separate line. 


IF NOT CONNECTED 
MeaonGe “sorry! © 
ENDIF 


this is correct 


“22 “SS «sa 


IF NOT CONNECTED MESSAGE "sorry!" this is incorrect 


ENDIF 


‘ao “SE 


Many commands have one or more additional arguments; if the argument is 
listed in brackets (C7) it is optional, otherwise it is required. 
Arguments listed within quotation marks (" ") should include the 
quotation marks; thus the command RUN, if you wish to use it to run 
WordStar, would be typed 

RUN "WORDS TAR" 
Arguments may be separated by blanks or commas. Thus both 

Bere ile AMODEM “PILES EXT™ 
and 

Sore lees AMODEM RP ILeJExT" 
are valid. 
To use the quotation character in a quoted string, precede it with. the 
special escape character ° (the reverse tick mark, or accent grave, ASCIT 
G6). Thus to print the message 

She said "Goodbye" and then went home. 
use the cammand 


MESSAGE "She said *"Goodbye’" and then went home." 


Labels are used as targets of GOTOs and GOSUBs. Labels must end with a 
colon. Eelow are some valid labels: 


LABEL 1: 
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FroComm 3. 4 Command Files 


This_is_a_long_label: 
JUMP: 

splits 

GO_HERE: 


Labels must appear on a line by themselves. (Comments are allowed on 
label lines; executable statements are mot). Labels may be of any 
length; however, only the first & characters are used by the interpreter. 
Thus LABEL TAGI: and LABEL TAGS are the same as far as FroComm is 
concerned. 


Peaments begin with a semi-colon (3). Any text following a semi-colon is 
treated as comment text. Kelow are valid comments: 


; This 168 a comment. 
LABEL 7s s'his i165 a comment on 4 label line 
TRANSMIT "Welcome back" sand this is a comment as well 


There are 10 string variables, named SO-S59, which may be set and used in 
place of quoted strings. They have a maximum length of 80 characters 
each. They may be set by the ASSIGN, GET and RGET commands. String 
Variables may be used in place of a quoted string in any of the commands 
marked below with the @ character. For example, the commands 


ASSIGN SS "Hello, Mike Todd here" 
TRANSMIT SS 


ane 
TRANSMIT “Hello, Mike Todd here" 


are functionally the same. One of the most useful applications of string 
Variables is in obtaining and using user responses. Consider the 
commands below: 


MESSAGE "Enter the name of the file to upload:" 
GET S4 
SENDFILE XMODEM S4 


String variables are also a very handy method for passing values between 
command files. When you chain from command file to command file, using 
the EXECUTE command, string variable contents are not reset. Thus you 
may set a variable in one command file, and act on the variable in 
another . 


FroComm allows the nesting of commands such as IF, SWITCH and GOSUB. 
Nesting, however, is limited to 10 levels. 


Characters that are received from a remote system are stored in the 
receive buffer. During command file execution, the receive buffer is 
emptied before each command is executed, with the exceptions noted below. 
What this means is that before each command is performed, all the 
characters that have come in are displayed on the screen and are 
therefore not available to be processed by later commands. The 
exceptions are the GET, RGET and WAITFOR commands, as well as labels and 
comments. In these cases the buffer is not emptied, allowing the command 
to process the accumulated characters. The point here is that if you 
have a command sequence that looks like 
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FroCommn 2. 4 Command Files 


TRANSMIT "password!" 
FAUSE S 

SET DUFLEX HALF 
WAITFOR "target" 


the text you are looking for may come in and be processed before the 
WAITTFOR command has a chance to see it. A better solution would be to 
change duplex at some other point, and let the WAITFOR command do the 
extra pausing: 


SET DOPLEX HALF 
TRANSMIT "password!" 
WAITFOR "target" 25 ; = seconds is the default pause 


Use the commands described below to perform your specific task. Be sure 
to test your command files thoroughly before using them for unattended 
communications. 


The following notations apply to the commands Listed below: Commands 
marked with an asterisk (#) may be tested with the IF command. Commands 
marked with an at-sign (@) indicate where string variables may be used in 
place of quoted strings. Sx indicates that you should use one of the 
string variables. Ellipses (...) mean that you may place a number of 
command lines in that spot. 


Top Level Commands 


ALARM Cseconds] 


The ALARM command will sound an alarm to alert you to some event. Use 
the (seconds] option to determine the amount of time the alarm will 
sound. If the [seconds] option is not specified FroComm will use the 
Alarm Time specified in the General SetUp screen. This command is also 
under control of the Alarm Sound setting. Both Alarm Sound and Alarm 
Time may be regulated using the SET command described below. 


Example: ALARM & ; sounds the alarm for 3 seconds 


ASSIGN Sx “string” @ 


This command assigns the contents of "string" to a user variable. Use 
ASSIGN to set a user variable from within your command file. 


Examples: ASSIGN SS "12245" 
ASSIGN Sé SS 


set SS to contain the string ‘123435° 
sets S6é to be the same as SS 


- 
BREAK Crime d 


The BREAK command is used to send a break to the remote system. The 
optional Ctimel argument determines the length of the break in 
milliseconds. If Ctimed is not specified, FroComm will use the default 
as indicated by the Ereak Length option in the Terminal SetUp screen. 
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FroCloamm 2. 4 Command Files 


Examples: BREAK ; send a break using the default timing 
BREAK Soo » send a 5300 millisecond break 
CHDIR "drive and/or directory" i 


The CHDIR command will change the logged directory and/or drive. 


Examples: CHDIR "A:" ; change the logged drive to A: 
GHDIR °C: \COMM" ; change to \COMM dir on drive Cs: 
Cabin = <COMr* ; change logged dir to \COMM 


CLEAR [Cbg fgi 


The CLEAR command is used to clear the top 24 lines of your screen. The 
optional parameter [Cbg fg] (you must use both codes) allows you to change 
your background (bq) and foreground (fg) colors. If the Cbg fg] option 
is not used, the screen will be cleared to the current colors. If the 
Cog fgJ option is used, FroComm will clear the screen to the new colors 
as well as reset the current colors to those specified. The codes to use 
for colors are as follows: 


© Black § Dk Grey (8-15 are the bright 
1 Blue 9 Lt Blue colors) 
= Green 10 Lt Green 
= Cyan Linus Cyan 
4 Red ea eee eee 
3 Magenta is Lt Magenta 
& Brown 14 Yellow 
7 Lt Grey iS White 
Only the codes O-7 are valid for background colors; any of the sixteen 


colors may be used for the foreground. 


Examples: CLEAR © 10 clear screen to lt green on black 


2s 


CLEAR clear screen to current colors 


“22 


DIAL "entry" @ 


The DIAL command is used to call an entry in your dialing directory. 
Specify the number of the entry, optionally preceded and/or followed by a 
long distance code identifier as the argument. 


Examples: DIAL "S" ; call entry number &S 
DIAL "#5" s call entry 3S using ld code ‘#' 


If a second command file is linked via the dialing directory to the entry 
being dialed, the linked command file will not be executed. Flace all 
statements to be executed in the command file which initiates the call. 


703 
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FroComm 2.4 Command Files 


Use the IF LINKED command to avoid secondary dialing in command files 
linked to dialing directory entries. For example, including the commands 


do not execute the dial command if 
this file is executing via linkage 
to a dialing directory entry 


IF NOT LINKED 
DIAL "5" 


“2s “SS son 


ENDIF 


in a command file linked to entry number 5 allows you to use that command 
file both as a stand alone file and linked to the dialing directory 
entry. 


This command uses the auto redial facility to place its eee Co 
keep re-dialing until a connection is made. To make a call without using 
auto redial, use the TRANSMIT command. 


Examples: TRANSMIT “ATDT1L 314 449-9401 1" 
FAUSE 10 
IF CONNECTED 


ENDIF 


place the call 
wait 10 seconds 


"Se ES 


do these commands if 
connected 


“S32 «sn 


Remember, if you sort your dialing directory you will need to change your 
command files so the entry numbers match. 


DOS "command" CWAITI a # 


The DOS command allows you to execute BOS commands or other programs from 
within a FroComm .CMD file. Enter the "command" as it would appear on 
the DOS command line. For example, to go out to DOS and type a file 
named FILE.EXT to your printer use the command: 


DOS “type FICE SEAT oer! 


If the optional argument WAIT is included, FProComm will wait for a 
keystroke after executing the command, before returning to ProComm. 


To execute this command properly you must make sure of two things. 

First, you must have enough memory to run the “command”. Secondly, 
COMMAND.COM must be where FroComm can find it. {Either in the boot 
location or wherever COMSPEC is pointing). While this command returns an 
error status checkable with the IF command, the error check is very 
limited. The DOS command will indicate FAILURE only if COMMAND. COM was 
not found. IF COMMAND.COM was found, even if the command to be executed 
was invalid, SUCCESS will be returned. 


Examples: DOS "del FILE.EXT" ; delete a file 
DOS “sortdisk" ; run a program called sortdisk 
IF FAILURE 


MESSAGE "“COMMAND.COM not found" 
ENDIF 


CAUTION: If you execute a program or command requiring user input be sure 
you are around to provide it, since the program will wait until you do. 


EMULATE terminal -or- EMULATE "terminal" 
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FroComm 3. Command Files 


The EMULATE command changes the active emulation to that specified. 
Valid terminal types are: VT100, VTS2, IBMS101, TV920, TYV950, ADMS, 
HEATHI9, ANSI, ADDSVF and WYSE1OO. 


Examples: EMULATE VT1Om 3; change emulation to VT1006 
EMULATE "IBMS1Oi1" ; emulate the S101 
EXECUTE "cmd file" | a 


The EXECUTE command allows you to begin execution of a different command 
file. The currently executing command file will be ended and will mot be 
returned toa. The EXECUTE commands allows a one-way chaining of command 
file execution. The file extension of .CMD need not be specified. 


Remember, string variables are not reset when chaining command files so 
you may use them to pass values. String variables are reset to null, 
however, when you begin the first command in the chain. 

4 ; 


Examples: EXECUTE "CALL FEN. CMD” 5; execute CALL FEN. CMD 


be So) s; get the option 
SWITCH SG 3; Switch based on opticn 
CASE "A" 
ASSIGN Sil "“CHOICEA.CMD" 
ENDCASE 
GASE Es" 
ASSIGN ST "CHETCER. CMD" 
ENDCASE 
DEFAULT 
ba516N (St) “OEP AULT. CMD" 
ENDCASE 
ENDSWITCH 
OA Me eS 1 


EAT 


The EXIT command terminates the executing command file and returns you toa 
Terminal Mode. 


Examples: TRANSMIT "Goodbye" ; log off remote 

HANGUE ; hangup phone 

ee a ; return to Terminal Mode 
FIND Sx "target" @ * 


The FIND command looks for an occurrence of the "target" string in the 
string variable Sx. Test for an occurrence of "target" within Sx using 
the IF FOUND command. The FIND command is not case sensitive. 


Examples: MESSAGE "Enter the password: " ; prompt 
MGET SO 4 get with mask 
FIND SO "password" ; look for password 
Le osOT “FOUND oe OER hn 
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FroComm 2. 4 Command Files 


MESSAGE "Invalid password" s not found, do this tode 
GOTG SECURITY BREACH 

Coe 
GOSUB WELCOME s toundgudo this 

ENDIF 


GET Sx Clengthi 


The GET command is used to obtain and store user input. The Sx argument 
determines which string variable is used to hold the data. The optional 
Clength] variable determines the maximum number of characters that will 
be accepted. If the Clength] argument is not specified, the maximum size 
of 80 characters is used. 

When responding to a GET command, the user must enter a «CR? to signal 
that his input is complete. The <CRe is mot included in the string 
variable. If the Clength] argument is used, the user will be allowed to 
enter up to Clength] number of characters, but still must use a «<CRe to 
complete his entry. ProComm will beep if the user attempts to enter more 
than Clength] characters. 


The MGET command is the same as the GET command except that the text the 
user enters is not displayed; rather each character typed will display as 
an asterisk (#). This is handy for security-related items such as 
passwords. 


Examples: MESSAGE "Enter your choices (A,B or CC)" 
Gel Sek 
SWLICH Ss 


ENDSWIT TCH 


MESSAGE "Enter the password” 

MGET SY 3 

FIND SS "secret" 

IF NOT FOUND 
MESS&GE “You are mot an authorized user." 
GUT T 

ENDIF 


GEIF ILE 
EER I 
ZMODEM “filename” 
WKMOBDEM “filename” 
RXMODEM "filename" 
YHODEM "filename" 


(Widowed KMODER) 
(Relaxed XMODEM) 


i fe fi tm fai 
* eK we eK RK K & 


BYMODEM (YMODEM Batch) 
TEL INE 

MODEM? ¥ 

ASCII "filename" @ 

CiSs * (CompuServe #8) 


The GETFILE command performs a file download (receive). A number of 
protocols are currently supported; see the section on file transfers far 
more information on @ach protocol. 
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FroClomm 2. 4 Command Files 


To perform a download you must first initiate the transfer on the remote. 
When that system indicates that it is ready, begin your transfer. 


Note that 4 protocols require you to specify the filename to receive; for 
the other protocols, the filename is provided by the sending system. All 
transfers may be checked for successful completion using the IF 
SUCCESS/FAILURE command. 


Wait till it’s ready 
receive FILE.EXT 


Examples: WAITFOR "Begin your transfer now” 
Geir itke AMODEM "FILE. EAT % 


"SS +s 


WAITFOR "Kermit-32>" 

MESSAGE “Enter file to transfer" 
Gey Si ; Kermit 

TRANSMIT "SEND " 

TRANSMIT Si 

TRANSMIT ' OM" 

GETFILE KERMIT 


wait for prompt 
transter a file with 


22 «a2 


send transfer command 
the tile name 

and a CR 

now get it 


“En ‘ME «es Ss 


GOSUB label 


The GOSUB command provides for an unconditional branch with return. Upon 
encountering a GOSUB command, the interpreter searches the command file 
for the label specified. If the label is found, execution will continue 
with the command immediately following the label. If the label is not 
found, the command file will terminate with an "Unexpected end of file" 
error. 


After successfully branching to the specified label, execution will 
continue until a RETURN command is found, at which point FroComm will 
jump back to the point at which the GOSUB was called. Execution resumes 
at the command immediately following the GOSUB. Each GOSUB must have its 
associated RETURN. 


GOSUBs may be nested to a depth of 10 Levels. If the end of the command 
file is encountered within a GOSUB, an "Unexpected end of file" error 
Wagk occur’. If you attempt to nest more than 16 GOSUB calls, a "Stack 
overflow" e@errocm will result. Likewise, if you attempt to RETURN without 
having a corresponding GOSUB, a "Stack underflow" error will occur. 


Examples: SWITCH So * Switch based on the contents of 50 

CASE "ABC" 

GOSUB LABELI 
ENDCASE 
CASE BEAN” 

GOSUEB LABELS 
ENDCASE 
DEFAULT 

GOSUB ERROR L 
ENDCASE 

ENDSWITCH 


; Subroutine area 
LABEL. Ls 
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FroComm 3.4 Command Files 


RETURN 


LABEL 2: 


RETURN 


ERROR 1: 


RETURN 


GOTO label 


The GOTO command performs an unconditional branch to the indicated label. 
Upon encountering a GOTO command, the interpreter searches the command 
file for the label specified. It the label is found, execution will 
continue with the command immediately following the label. If the label 
is not found, the command file will terminate with an “Unexpected end of 
file" error. Remember, only the first 8 characters of a label are 
actually used. Tf two identical labels exists, FroClomm will branch to 
the one closest to the beginning of the file. 


GOTOs may not be used to jump into the middie of IF or SWITCH statements, 
although they may be used to branch out of those constructs. They should 
also not be used to branch into or out of subroutines (code segments 
designed to be used with the GOSUB command), although they may be used 
within the boundaries of individual subroutines. Use of a GOTO in these 
Situations will result in unexpected and usually erroneous execution. 


Examples: IF NOT WAITFOR 
GOTO ERROR_EXIT s this is OF 
ENDIF 
ERROR_EXIT: 
MESSAGE “Abnormal termination” 
HANGUPF 
QUIT 


; 
: 
5 


GOTO LABEL? se eee ee 
SWITCH SG 
BASE nieve 
LABEL 1s 
etc. 
HANGUF % 
The HANGUF command attempts to disconnect the phone in the manner 
described for the Alt-H command in Section 3. Use the IF CONNECTED 


command to determine if you successfully disconnected. 


Ex amp] @s HANGUPF 4 disconmect the phone 


HOST 


The HOST command is used to put FroComm inte Host Mode. 
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FroaComm 2.4 Command Files 
Examples HOST ; enter host mode 


temeconedi baer 


The IF command is used to make decisions. The syntax of the IF statement 
is 
fe cund: tron 
CTpart 14 
Biot 
[part 2 
ENDIF 


where the ELSE part is optional. The condition is evaluatedy if it is 
true, Cpart Ld is executed. If it 18s false, and there is an ELSE, 

[part 2] is executed. There must be an ENDIF for every IF. IF commands 
may be nested up to 10 levels deep. 


Valid conditions for the IF command are 


SUCCESS CONNECTED FOUND 
FAILURE LINKED WAITFOR 


The SUCCESS condition is @valuated as true if the last checkable command 
Was successfully executed. A "“checkable” command is a command file 
command that sets one of the condition flags. Checkable commands are 
indicated in this chapter by having an asterisk (*) after the command 
name. For examples: 


RUN "someprog" 

CF SUCCESS 

nae ; this segment will execute if "someprog" ran. 
ENDIF 


The FAILURE condition is considered true if the last cnheckable command 
was not successfully completed. For example, if you had an RGET command 
that timed out, FAILURE would be considered trues 


RoEtigos Sus 

IF FAILURE 

ee ; this segment will execute if RGET times out. 
ENDIF 


The CONNECTED condition is true if CD (Carrier Detect) is found to be 
high. CD is high when you are connected to a remote system, or if your 
modem is forcing the CD lead high. WARNING: be sure that your modem does 
not force CD high (usually a dip switch setting) or the CONNECTED 
condition will always be true. 


£P OGONNECTED 
See ; perform this segment if you are connected 
ENDIF 


The LINKED condition is considered true if the command file that is 
executing was started because it was linked to an entry in the dialing 
directory. In other words, if you have a command file called VAX.CMD 
which is linked to dialing directory entry number 3S, and you call entry 
number S and are connected, and VAX.CMD begins execution, an TF command 
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that looks like 


iF LINKED 


ENDIF 


Will be considered true. The primary use for the LINEED condition is so 
you can write one command file and use it both stand alone and linked to 
dialing directory entries. 


IF NOT LINKED 
DIAL. 3 
ENDIF 


In this code segment, the DIAL command will be executed only if the 
command file was not executed because of a dialing directory link. (More 
on the NOT option below). 


The FOUND condition is used to test the result of the last FIND command 
executed. Tt is considered true if the "target" was found in the 
specified string variable. For example, in the sequence 


ASSIGN S9 “ABCDEFG" 
Paw SS) CDpeEY. 
TF FOUND 


ENDIF 


the commands denoted by ellipses (...) would be executed, as the FOUND 
condition would be true. 


The WAITFOR condition is used to check the result of the last WAITFOR 
cammand. If the "target" specified in the WAITFOR command was received, 
the WAITFOR condition would be true. If the WAITFOR command timed out 
before receiving the "target", the condition would be false. 


WAITFOR "ABCDEFG" 15 ; Wait 1S seconds for ‘ABCDEFG’ 
IF WAITFOR 
Gaal ; @xecute if “ABCDEFG’ was received 
ELSE 
Soe ; @xecute if timed out 
ENDIF 


The NOT operative may be employed with any of the conditionals. The 
effect of the NOT is to reverse the value of the condition. For example, 
if CONNECTED is false, then NOT CONNECTED would be true. The conditions 
NOT SUCCESS and FAILED are exactly the same. The code seqments 


IF FOUND IF NOT FOUND 
Lper Gia.d Pparn 23 
ELSE ELSE 
Epart 23 Lpat eu 
ENDIF ENDIF 


Will result in identical execution. 


Exampless IF NOT CONNECTED 
iil ; darthisti*+ no connection 


i 
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ENDIF 
e WAITFOR "Something" 
IF WAITFOR 
meen s do this if it was found 
poll Mist 2 
aan ; @lse do this 
ENDIF 


SED ses 

SCMUrGCE ERM): Peale. Ex TS 

Leno SUCCESS 
MESSAGE "Error in file transfer. Retrying..." 
GOTO SEND. IT 

ENDIF 


: How to redial without using Alt-F 


Dott: 

TRANSMIT "“ATDT123-4567" 

WAITTFOR "CONNECT" 2o 

IF NOT WAILTFOR 
MESSAGE. “Nowconmect. Kedialing...” 
GOte DOIT 

ENDIF 


ms 


9 ISFILE "filename" @ # 


The ISFILE command is used to determine if a specific file exists in the 
current directory. Use the IF SUCCESS/FAILURE command to test the 
results of the ISFILE command. 


Examples: SSF2LE “proacemm: dec" 
tire oSuCle Ss 
MESSAGE "Doc file exists" 
0 Wee) 
MESSAGE "Doc file not found" 
ENDIF 


MESSAGE “Enter filename" 
GET 50 
Us| a 9 ice 
Lie NOTSESOLGESS 
MESSAGE "File does not exist" 
ENDIF 


RERMSERVE 


SENDFILE "filename" @ * 
GETFILE "filename" a@ 
FINISH 
LOGOUT 


The FERMSERVE command may be used to issue a Fermit server command. The 
available commands are listed above. 


Examples: MESSAGE "File to send?" § prompt for filename 
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Ger "Se 
ERERMSERVE SENDFILE So 
KERMSERVE FINISH 


KFLUSH 


Command Files 


5; get filename 
; send file 
alice § 


esue the FINISH server command 


The EFLUSH command is used to clear any accumulated keystrokes from the 


keyboard buffer. 
processed, will be lost. 


Examples: EFLUSH 


LOCATE row col 


The LOCATE command positions the 


Any keystrokes that have been entered, but not 


5 Clear keyboard buffer 


cursor to the location specified by row 
colunna OU-7F, °WwitieG,0) tow 0, 
the screen. 


clear the screen 
position curser 


4 Position at end of line 


and col (column). Rows are numbered O-24, 
col ©} being the upper left corner of 
Examples: CLEAR : 
LOCATE. 1a 20 ; 
PiBSSAGE “ENTER CHOICE:" 
LOCATE 10 44 
GE, oc 
LOG 
OPEN € "filename" J @ * 
CLOSE 
SUSPEND 
RESUME 


The LOG command controls file logging during command file execution. 
the OFEN command to start logging data to disk. 


present, the Default Log File as 
will be used. 
SUSFEND command will 
closing the log file. 
SUSPEND command. 


LOG OFEN 
LOG SUSFEND 
LOG RESUME 


LGb’ Close 


Ex amp 1] ess 


‘an 


“25 


“22 


MACRO mumber ~-or- MACRO “number " 


The MACRO command will 
macro keys 
individual 


Examples: MACRO 5 H 


Bepyright <(C) 


Use the CLOSE command to turn off file logging. 
stop text from being logged temporarily without 
Use the RESUME command to 


send the string currently 
C(ALt-O through ALt-9). 
keyboard macro definition files. 
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Tf "filename" is not 
specified in the General SetUp section 
The 


continue logging after a 


use detrault log name 
But Log or: (hold 


resume logging 
close log 
@ 
assigned to any of the 


Use the FLOAD command to load 


send macro assigned to ALt-S 
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FroComm 2.4 Command Files 


ASSIGN Sa "2" 
MACRO S& ; $end macro assigned to Alt~-2 


MESSAGE "string" @ 


The MESSAGE command displays a string on the local console. The text is 
not sent to the remote. The message is displayed at the current cursor 
position, in the current colors. MESSAGE will always do a CR/LF after 
@ach string. The "string" may contain control characters such as CR and 
LF by using the translation conventions described in Section 2. Use the 
MESSAGE command for prompts, informational messages, building menus, etc. 


Examples: MESSAGE ' t---—-—mee ee e 
MESSAGE "I Enter your choices: de 
MESSAGE TU fs see mate sens sees aes nnen ete mary snes mnt sens ant anes mer ent oune sens sss sxe vate ene eee HY 
ROCene 2,20 
GET So. 4 
SWITCH St 
etc. 


ASSIGN S9 "This is the first line“M*JThis is the second" 
MESSAGE: SY 

MLOAD "filename" @ 

The MLOAD command is used to load a keyboard macro file. 


Example: MLOUAD “SvVSTEMA. KEY” 5; load a néw macro file 


FAUSE seconds ~-or- FAUSE "seconds" 


The FAUSE command halts command file execution for the specified number 
of seconds. Characters received during a pause are not displayed until 
after the pause has completed. 


start the transfer 
let the remote start 
receive the file 


Examples: TRANSMIT "Kermit send file.ext" 
PAUSE 3 
RERMLT RECEIVE 


“23 “ES csc 


PRINTER 
ON 
OFF 


The PRINTER command is use to control print logging. Use the ON argument 
to begin logging the session to the printer; use OFF to end logging. 
FroComm writes the printer log to the DOS device PRN. You can use the 
MODE command in DOS to redirect printer output. 


Examples: FRINTER ON s begin print logging 


PRINTER. OFF ; end print logging 


QUIT 
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FroComm 2.4 Command Files 


The QUIT command terminates the executing command file and exits FProComm 
9X as well. Use it only to shut down the entire program. 


Examples: TRANSMIT "Logoff" 
HANGUF 
QUT T 


log off remote 
hangup the phone 
close down FroComm 


“25 “SE «ss 


RFLUSH 


The RFLUSH command is used to clear the input buffer. Any characters 

that have been received, but not yet displayed, will be lost when this 
command is issued. It 18 generally used to clear the input buffer in 

preparation for some task. 


Examples RE LUSH ; Clear the input buffer 


RGET Sx Clength] Cdelay] % 


The RGET command provides services similar to those of the GET commarnc s 
however, input is taken from the remote computer rather than from the 
keyboard. The RGET command will complete when a <CR> is received or 
Clength] characters have been received. Unlike with the GET command, a 
{CRe is not required if Clength] characters have been received. Use the 
[delay] argument to specify the maximum number of seconds to wait for the 

a string to be received before timing out. If [delay] seconds have elapsed 

=) without receiving a <CR> or CLlength] characters, the RGET command will 
timeout and execution will continue. You can determine if the command 
timed out using the IF SUCCESS/FAILED command. You must specify Clength] 
if you wish to specify Cdelayl. If length is not specified, the maximum 
of 80 characters is used; if [Cdelay] is not specified, the default of 30 
seconds is used. 


Examples: TRANSMIT "ATSO=1-M" 5 gO into auto answer 
WAIT IT GUT: 
IF NOT CONNECTED ; Wait for a connection 
GOTO WAIT IT OUT 
ENDIF 
TRANSMIT "ENTER FASSWORDs: " 
RAGE Tse eas ; Walt 45 seconds max 
LE PA tkep y timed out 
TRANSMIT “Times up. Goodbye" 
HANGUFE 
BOTO WAIT IT OUT 
ENDIF 


FIND S9 "secret" 
IF NOT FOUND 
TRANSMIT “Sorry , but you’re not authorized.” 
HANGUF 
GOTO WAIT IT _OUT 
’ ENDIF 
RUN "program" CWAITI @ * 


The RUN command is similar to the DOS command except that it cannot 
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FroCamm 2. 4 Command Files 


execute internal DOS commands. See the explanation of the DOS command 
for conditions necessary for the correct execution of this command. rx 
major difference between the BOS and the RUN commands is the error codes 
returned. RUN will report any non-zero return code from the "program" as 
FAILURE; only "programs" exiting with a return code of zero will indicate 
mE SS « 


If the optional argument WAIT is included, FroComm will wait for a 
keystroke after executing the program, before returning to Fro Comm. 


Examples: RUN Si OCIS SSN ee ; @xecute a program called filesort 


ASSIGN SO "filesort" 
RUN So 
LP PALLURE 
MESSAGE "filesort returned error" 
ELSE 
MESSAGE "“filesort executed successfully" 
ENDIF 


SENDF ILE 

KERMIT "filename" 
RAMODEM "filename" 
MODEM "filename" 
YRODEM "filename" 
BYMODEM "filename" 
TELINE "filename" 
MODEM? "filename" 
ASCII "filename" 
CISH "filename" (CompuServe 6) 
WKMODEM "filename" G@ # (Windowed XMODEM) 


ihelaxed XMODEM: 


CYMODEM Batch) 


fai (2 a fa eh a 
ee eK KK eK * 


The SENDFILE command performs a file upload (send). Many different 
protocols are currently supported; see the section on file transfers for 
more information on each protecol. 


To perform an upload you must first initiate the transfer on the remote. 
When that system indicates that it is ready, begin your transfer. 


All F protecols require that you specify the filename to send. All 
transfers may be checked for successful completion using the IF 
SUCCESS/FAILURE command. 


wait till it’s ready 
send FILE.EXT 


Examples: WAITFOR "Begin your transfer now" 
EMD Er MOO or Ie eaxit | 


“SE «us 


wait for prompt 
transter a file with 
ering t 

send transfer command 
the file name 

and a CR 

now send it 


WAITFOR "“Kermit-322" 

MESSAGE “Enter file to transfer" 
Sia IE Sa| 

TRANSMIT “RECEIVE" 

TRANSMIT Sl 

TRANSMIT "mM" 

SENDFILE KERMIT Sil 


“S82 “SS «en BE «se “SE ees 
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FroGomm 2. Command Files 


The SET command is used to control various system parameters and options. 
{Tt is fully described in the next section. 

SNAPSHOT 

The SNAPSHOT command performs a screen dump as described in Section 3. 


Examples SNAFSHOT | s dump the screen contents to the .IMG file 


SWITCH S» 


The SWITCH command provides special multi-way decision making. A SWITCH 
compares the value of a string variable against a number of constants and 
branches accordingly. The syntax of a SWITCH command is: 


Seu Se 3; Switch based on S23 
CASE "targeti" os, =  Largetl- 
ee ; do these commands 
ENDCASE ,; until here 
CASE "targets" ; any number of cases 
ENDCASE ; needed for each case 
DEFAULT ; if no previous case matches 
Schr ; do these commands 
ENDCASE 
ENDSWITCH ; ends the SWITCH 


The string variable Sx contains some value, usually put there by a GET or 
RGET command. When a SWITCH command is found, FProComm begins looking for 
a CASE statement that contains a "target" which matches the string 
Variable specified in the SWITCH. The match must be complete, although 
it 16 not case sensitive. Thus the values ‘ABC’, ‘abc’ or ‘AbC’ would 
all match a CASE ‘abe’ command, but the values ‘“ABCDE’, ‘KY¥Zabc’ or 
Sc Would not. 


After finding a CASE that matches, FroComm will continue command file 
execution starting with the command immediately following the matcning 
CASE. Execution continues until an ENDCASE command is found. At that 
point FroComm skips to the command immediately following the matching 
ENDSWITCH command and resumes execution. Note that each CASE statement 
must have a matching ENDCASE, and each SWITCH a matching ENDSWITCH. 


There is a special case known as the DEFAULT case. The commands within 
the DEFAULT case will be executed if no previous CASE matched the string 
Variable. The DEFAULT case is optional and need mot be specified. If 
there is no DEFAULT case, and no other match is found, command file 
execution will continue with the statement following the ENDSWITCH 
commarncl . 


Another special case the NULL case. The NULL case will be executed if 
the string variable being switched on is null, i.e@., has no value. For 
example, if a user enters a CR only in reply to a GET or RGET command, 
the string variable being gotten will be null. The NULL case would then 
be triggered. The correct syntax for the NULL case iss 


CASE “ NUCL® 
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FroComm 2. 4 Command Files 


Ex amp less (display some menu of options) 
See CHO. es 
MESSAGE “Enter your choice” 


GET -S5 
Swi Tih Sa ; Switch based on 55 
CASE "A" State coe eA tee ey 
GOSUB CHOICEA 5 da this 
ENDCASE 
CASE "B" Pit teg = oor 8 
GOSUB CHOICERB 7 do-this 
ENDCASE 
CASes Suni ; do this if user pressed 
GOSUB NULL CASE Sori yo 
ENDCASE 
DEFAULT Seon = Lei oe or oR sor. NULL 


MESSAGE "invalid selection" 
FAUSE 
BOO Gel: CHOLCE 
ENDCASE 
ENDSWITCH 


MESSAGE "Continue? (Yes/Nod" 3: prompt 
Sec has7 3; get response 
SWITCH S7 ; Switch based on response 
CASE “NO ; they said "no" 
CHT T ; 80 leave 
ENDCASE 


ENDSWITCH 


One use of a SWITCH command is to get a choice from the user, and then to 
perform various tasks depending upon the option selected. In the first 
example, the command file would begin by presenting some list of options. 
You could easily build a menu using the MESSAGE and LOCATE commands. The 
command file could then prompt the user for his selection, and GET the 
selection into a string variable, in this case 55. The command file wiil 
branch based on the user’s selection. If the user entered the letter 
‘A’, the SWITCH will execute the first case and call the subroutine 
entitled CHOICEA. After returning from that subroutine, execution will 
continue with the first statement following the ENDSWITCH command. it 
the user had entered ‘B’ as his choice, the CHOICER subroutine would nave 
been executed. 


If neither ‘A’ nor ‘'B’ had been entered by the user the DEFAULT case 
would execute. In that event the "Invalid selection” message would he 
displayed, the program would pause for 3 seconds, and then branch back up 
to the GET CHOICE label and the process would be repeated. 


In the second example, if the user had entered ‘No’ the first case would 


execute and the command file would QUIT. In all other cases, no part of 
the SWITCH would execute, and the command file would continue. 


TRACE ON/OFF 


The TRACE command allows you to "trace" the execution of a command file. 
If you set TRACE ON, every command will be printed to the screen, in 
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FroComm =. Command Files 


contrasting colors, as it is @xecuted. TRACE is very handy for debugging 
errant command files. 


Examples: TRACE ON ; set trace on 


TRANSMIT "string" @ 


The TRANSMIT command sends a character string to the remote. The 
"string" may contain control characters using the standard translation 
conventions. 


Examples: MESSAGE "Enter your ITD" 
BESS 
TRANSMIT Sé 
TRANSHIT "1" 


send the prompt 
get the ID 

send the ID 
plus a CR 


“BO ses “ES sas 


WAITFOR "First mames” 
TRANSMIT "TOM!" 


Wait for a& prompt 
send the name plus a CR 


“SR ssn 


WAITTFOR “target” Cdelayd @ * 


The WAITFOR command allows you to wait for a particular string to be 
received from the remote before command file execution continues. The 
t[delay] option tells FroComm how many seconds to wait for the "target" 
before timing out and continuing execution. Tf mo ECdelay] is specified, 
FroComm will wait 30 seconds. 


Use the IF WAITFOR condition to test the results of a WAITFOR command. 


Examples: WAITFOR "first names" 45 : wait for the string "first name" 
s for 45 seconds 
IF WAITFOR ; if it was found w/o timing out 
TRANSMIT "TOM!" , send your name 
ELGE ; else 
GOTO ERROR s go to error processing 
ENDIF 


WAITFOR targets are not case sensitive, thus either "FIRST NAME" or 
"First Name" would successfully complete the command sequence above. You 
may also include control character in the target using the translation 
conventions described earlier. 


Example: WAITFOR "“hM"IBUSY" wait for CR LF then BUSY 


WHEN “target” "response" @ 


The WHEN command is used to transmit a certain "response" text every time 
a certain "target" text is received. Once a WHEN command is initiated, 
it will be in effect until a CWHEN (Clear WHEN) command is found or the 
command file ends. For example, suppose you are calling an online 
service that displays a "-more-" prompt at the end of each page of 
display, and waits for you to enter a carriage return before i ol 
continues. By specifying the command 


WHEN. S=morer MOM 
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FroClomm 2, 4 Command Files 


at the beginning of the command file, you are instructing FroComm to 
transmit a CR ("M) every time it receives the string "-more-", thus 
relieving you of the task of matching every occurrence of "~more- 


with a 


WAITFOR "“~more-" 
TRANSMIT USM" 


command se CULLEN CE a» 


Examples: WHEN “continue? (Y¥/ND" "Yr" s send a ‘YiCR?‘' for 
gana 4; every “continue” received 
CWHEN y turn of f WHEN processing 


Set Commands 


All SET commands have the same format: 
SET parameter value 


The SET commands are used to change the value of the parameters in the 
SetUp facility (ALt-5) and the Line Settings window (Alt-F). Available 
Yalues are separated by slashes (/). Because those parameters are 
described in detail in other sections, an in-depth discussion is not 
presented here. The appropriate Setup section is indicated in 
parenthesis for each command. 


Set ASCII etc. (ASCII Transter Setup) 
The ASCII transfer SET commands are covered below. 


SET ALARM ON/OFF (General Setup} 
Controls alarm sound. 


SET ATIME secands (General Setup) 
Sets amount of time alarm sounds. 


SET BACKSFACE IN NONDEST/DEST (Terminal Setup 
Controls destructive nature of received HS. 


SET BACKSFACE OUT BACK SPACE /DELETE (Terminal Setup) 
Controls character sent when BS key pressed. 


SET BAUDRATE SOG/1200/4800/9400/19200 (Line Settings? 
Sets the baud rate. 


SET BREAK milliseconds (Terminal Setup) 
Sets length, in milliseconds, of break condition. 


Sereorn IN CRYCR_ LF (Terminal Setup) 
Controls incoming CR translation. 


Sen LCR OUT CR/CR_LF (Terminal Setup?) 
Cantrols outgoing CR translation. 
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Frotomm 2. 4 Cammand Files 


SET DATABITS 7/8 (Line Settings) 
Sets the data bits used. 


eet DLDIK. "path" @ (General Setup) 
Sets the default download drive and directory. 


eet DUPLEX HALF/FULL (General Setup) 
Controls the duplex setting. 


oe) ENG ON/OFF /CISB (Terminal Setup) 
Controls response to ENG (ASCII S&S). 


Se! PLOWCTRL ON/OFF’ (Terminal Setup) 
Controls use of XON/OFF flow control. 


Se MUSTFSWD “string” @ {Host Mode Setup) 
Sets the host mode password. 


SET FARITY EVEN/ODD/NONE/MARE / SPACE (Line Settings) 
Controls parity. 


SET FORT COMI /COM2S/COMS/COM4 (Line Settings) 
Selects serial port to use. 


SET RDELAY seconds (Modem Setup) 
Determines timeout period for redials. 


Seer ON/OFF (Terminal Setup) 
Determines scroll setting. 


Ser SHELLPSWD “string” a (Host Mode Setup) 
Sets the host mode shell password. 


Set SOUND ON/OFF (General Setup) 
Controls sound effects. 


eee SlOPBITS i/2 (Line Settings) 
Sets the stop bits used. 


SET SWRITE BIOS/DIRECT (General Setup) 
Determines the screen write method. 


SET TRANSLATE ON/OFF (General Setup) 
Controls use of the translate table. 


SET TXPACE millisecs 
Determines pacing for all outgoing character strings. 


SET WRAP ON/OFF (Terminal Setup) 
Controls line wrap. 


Set ASCII Commands (ASCII Transfer Setup) 


SET ASCII BLANKEX ON/OFF 
Controls expansion of blank lines during ASCII uploads. 


fe) 
bh 
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FroComm 2. 4 Command Files 


SET ASCII CHARFPACE milliseconds 
Sets the character pacing (in milliseconds). 


Set ASCII DNOCR CR/CR_LE/STRIF 
Controls translation of incoming CRs during ASCIT downloads. 


Pet eneciie ON LE LE /GROLE/STRIF 
Controls translation of incoming LFs during ASCIT downloads. 


SET ASCII ECHO ON/OFF 
Controls local echo during ASCII uploads. 


SET ASCII LINEPACE tenths 
Gets line pacing timing (in 1/10 seconds). 


SET ASCII FPACECHAR number 
Sets the pace character used. Specify as an ASCII decimal value. 


SET ASCII UF_CR CR/CR_LF/STRIF 
Controls translation of outgoing CRs in ASCIT uploads. 


SET ASCII UP_LF LF/CR_LF/STRIPF 
Controls translation of outgoing LFs in ASCIT uploads. 


Sat Kermit Commands 


SET KERMIT CQUOTE char 
Set the Ctrl quote character. 


SET KERMIT FACKSIZE number 
Set the maximum packet size. 


SET KERMIT FADCHAR char 
Select the pad character. 


SET KERMIT FADNUM number 
Set the number of pad characters. 


SET KERMIT SQUOQTE char 
Select the 8th bit quote character. 


SET KERMIT HANDSHAKE char 
Select the handshake character. 


SET KERMIT EQLCHAR char 
Select the end of line character. 


SET KERMIT BLOCKECHECKE 1/2/23 
Select the block check type. i= 1 byte checksum, 2 = 2 byte 
checksum, 3 = 3 byte CRC. 

SET KERMIT FILETYFE TEXT/BINARY 
Select the transfer file type. 


arguments listed as "char" should use the ASCII decimal value of the 
desired character. For example, to use XON (ASCII 17) as the HANDSHAKE 
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Frolomm 2. 4 Command Files 


character, issue the command 


SET KERMIT HANDSHAKE 17 


ERROR MESSAGES 


If an error is encountered during the execution of a command file, an 
error message will be displayed and command file execution will stop. 
Error messages begin with the error number (described below), followed by 
the line number of the line containing the error, followed by the 
erroneous line itself, for example: 


ERROR 2, LINE 6: goto missing label 


ERROR NUMBER DESCRIPTION 
Wee cecuie icteee LVatoe) token. 
aa Risse mle We wo Unexpected end of file. 


weeee ee eens Unexpected CASE statement. 
eesoeneanae Un@xpected DEFAULT statement. 
eeeeeee nee Un@xpected ENDCASE statement. 


“JO Of i bie 


ae Seca ee ee Unexpected ENDSWITCH statement. 
oe eteiacn ee ae 8 Unexpected ELSE statement. 

Cle ugala geil ae eteess Unexpected ENDIF statement. 

Da San aoe Unexpected token. 

TAD valle ene tells gun's ow Missing token, 

Oe Oe on tae er Stack overtlow. 

Rie Wore ut nian a cesta n ya Stack underflow. 


ERROR t - Invalid token 


Indicates that an unidentified keyword was found, oar that an invalid 
argument was included. 


ERROR 2 - Unexpected end of file 

Indicates that the end of file was reached while executing same command. 
May be triggered by IF statements without their corresponding ENDIF; 
SWITCH statements without an ENDSWITCHs; or when attempting to find a 
label that does not exit. 

ERROR 2 to 8 - Unexpected [Ctokend 

Indicates that the given keyword was found in an unexpected place, 1.6. 
an ELSE command with no preceding IF, or a DEFAULT command with no 
preceding SWITCH. 

ERROR 9 - Unexpected token 


Indicates that a keyword or argument was supplied where none are 
expected. 


ERROR 10 ~- Missing token 


Indicates that a token or argument was expected, but not supplied. 
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FroComm 2.4 Command Files 


ERROR 11 —- Stack overflow 


Indicates that nesting has gone too deep, i.e. an iith level in a nested 
if statement, or an attempt to access an Lith level subroutine. 


ERROR 12 ~ Stack underflow 


Indicates the attempt to return a level when no nesting has occurred. 
For example a RETURN command when no GOSUB has executed. 
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FroaComm 2.4 Host Mode 


Cee tt Cer tee tS De 


FroComm includes a limited remote access facility known as Host Mode. 
Host Mode allows remote access to your computer for tasks such as file 
transfer and DOS shell access. In addition, it provides password 
security, a logon message, and can maintain a history of logons. Host 
Mode is intended to allow a user access to his home machine from work (Cor 
vice versa); it is not intended as a multi-user message base or bulletin 
board system. 


Host Mode Setup 


Host mode requires some setup before it can be used. Setup is composed 
of three basic parts: modem, operating system, and FroComm. Each must be 
correctly configured before attempting to use Host Mode. 


Modem Setup 


Host Mode depends quite a bit on the correct installation of your MOEN « 
Because there are many different modems available, not all of which we 
are familiar with, you may have to do a bit of reading in your modem 
manual . 


First, Carrier Detect (CD) on your modem must be set to follow the true 
state of carrier. Carrier detect must not be forced true, or high, by 
dip switch settings. Carrier detect also should not be set to follow 
DTR. It should be set to follow the "real state", or the "RS-232 
convention" or however your manual says it. Carrier detect is usually 
controlled by a dip switch setting on your modem, although on some new 
modems, like the Hayes 2400, you use a software command like &C1 and &D. 
On a Hayes 1200 external modem you should have dip switch 6 in the UF 
position. 


Next, data terminal ready (DTR) should also follow the real state. i 
should not be forced high. On a Hayes modem, this means switch i is UF. 


Your cable might also have an impact on correct operation. Your macem 
manual should have an explanation of proper cable configurations. 


Operating System Setup 


Operating system setup revolves around the CONFIG.SYS file. CONFIG.SYS 
is a configuration file which contains commands used to configure your 
system. Each time you start DOS, the operating systems searches the root 
directory of the drive you booted from for a file called CONFIG .SYS. Let 
it is found, DOS reads the file and interprets the commands it contains. 
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FroComm 2. 4 Host Mode 


You may create a CONFIG.SYS file using your favorite editor or word 
processor (be sure to save it as a non-document, or ASCII file). Tf you 
add or change any of the commands in the configuration file, or create a 
new one, the changes are not in effect until the next time you start BOS, 
sO be sure to reboot. Consult your DOS manual for more information about 
configuring your system. 


The command in the CONFIG.SYS file that we are concerned with is the 
FILES= statement. This command controls the number of files that can be 
open at one time. The operating system default is Gs for FroComm we 
recommend 20 or higher. 
To set this statement, create (or edit) a CONFIG.SYS file in the root 
directory of the digk that you boot with. Include in the CONFIG.SYS file 
a line that says 

FILES=x 


where “~ i6 20 or greater. A quick and easy way to create the CONFIG.SYS 
file is thiss 


At the DOS prompt type 

COPyer Uh CON LG, SYS) “GR 

FILES=20 <CR> 

Tees RS (Press Ctrl-Z then «<CRe) 
Remember, the CONFIG.SYS file, containing the FILES= statement, must be 
present im the root directory when you boot. It has no effect otherwise. 
Increasing the FILES= parameter can also alleviate other problems 
indicated by "CAN’T OFEN FILE” messages and similar notices. 
FroCommn Setup 
The SetUp facility (Alt-S) contains a section for Host Mode Setup. The 
Host Mode setup screen contains six host options which must be 
initialized. These options are also described in Section 3. 
The first option is the Host ID String. The Host ID String is a text 
message that is displayed to callers after they connect. Tt is usually 
used as a greeting. 
The second option is the modem auto-answer string. This string is the 
command sent to the modem to place it into auto answer mode. The default 
string, set for Hayes compatible modems, is "™*%+4+4+*""°ATSO=1'", where 

“™™ i186 a 1 i/S second pause 

+++ drops the modem into command state 

vw™™ 15 a 1 i/2 second pause 

AT is the command prefix 


$SO=] sets modem to answer after one ring 


' sends a CRS. 
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FroClomm 2. 4 Host Mode 


When host mode is exited, the Modem Initialization String (specified in 
the Modem setup section) is sent to the modem to reset it. Tac erga eMere ten gia 
want auto~-answer to be on when you are not in host mode, include the 
command to turn it off within the Modem Initialization Steings. That 
command is SO0=0 for Hayes compatible modems. 


The third host option is the Host Access Fassword. It may be up to 8 
characters long. Callers must match the password exactly, including 
upper- and lower-case, If you set the host access password to WGI, 
callers need only press <CR> at the password Prompt to be allowed on your 
system. 


The fourth host option is the DOS Shell Password. This password provides 
a second level of protection before callers are allowed access to the 
system level. Be very careful with this ones; you don’t want just anyone 
to have access to the operating system level on your machine. 


The fifth host setup option is the Auto Baud Detect method. Three 
cheices are available: NONE, KEY HIT and MODEM MSG. These choices 
determine what technique, if any, FroComm will use to attempt to 
synchronize baud rates with callers. 


The last host option is the Connection Type. This allows you to run Host 
Mode either directly connected to another machine, or by using a modem. 
When set to Direct, FroComm automatically assumes a comnection exists, 
and does not look for carrier or attempt baud rate synchronization. 


Once you have set the options and assured that your modem is correctly 
configured, you can place FroComm into Host Mode by pressing Alt-Gi. The 
autor-answer string is sent to the modem, and the local console displays 
‘os Sige In addition, a line is added to PROCOMM.HST, the host 
audit trail history file, that records the time and date. 


When a call comes in, and an Auto Baud Detect method other than None is 
specified, FroComm will attempt to match baud rates. After the 
connection is complete, FroComm will send the Host ID String and prompt 
the user for his name. The name is for informational purposes only. The 
caller's name is then recorded in the history file. FProComm then prompts 
the caller for the password. The caller must match the password 
completely, including case. All password attempts, both successful and 
otherwise, are recorded in the history file. Callers get three chances 
to match the password; if they are unsuccessful after three tries, 
FraComm will hang up on them. 


If the caller makes it past the password, FroComm will display the 
contents of a special file called FROCOMM.MSG, if that file exists. You 
can use this file as a welcome message, to display character graphics, or 
whatever. Every 23 lines FroComm will halt, display a "CMORE]" MESSACES y 
and wait for any keystroke from the caller. When a keystroke is 
received, the display of the file continues. Use of the .MSG file is 
aptional. 


After FPROCOMM.MSG is displayed (if it is), the caller is presented with 
the host menu: 


Foiles Cihat Download Upload S)hell Goodbye 
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FroComm 2.4 Host Mode 


Callers make their choices by entering the first letter of an option and 
pressing <CR?. 


The Files option will send a list of the files in the current directory 
to the caller. The list is not displayed on the local console. Fiiles 
uses the same facility as the Alt-F command, described earlier. 

[If the caller chooses Cihat, an alarm on the host computer will sound for 
20 seconds. The Host operator can press Space to chat with the caller. 
Fressing any other key will end the alarm and redisplay the host menu. 

If you have the alarm sound set off (via general setup at the Alt-S menu) 
no bells will sound on the local end. Fress <ESC> to return to the host 
manu when you are done chatting. 


Diownload and Upload work pretty much the same. The caller is presented 
with the file transfer menus 


Elbermit Miodem? Tielink Ximodem Yimodem batch 


After selecting a protocol the caller may be prompted for a filename, 
depending upon the transfer direction and protocol used. The standard 
file transfer routines are used to perform the transfers. Users are only 
allowed to download files in the current directory. Similarly, all files 
uploaded will go to the current directory. 


The Shell command is very powerful, but it also has the potential of 
being very dangerous. Tt performs the equivalent of a "CTTY COM" 
command, which basically redirects all console I/O out the COM port. The 
Shell command puts the caller in charge of your computer at the operating 
system (DOS) level. This means that a user can format your disk or 
whatever, sO be very, very careful about who is allowed access to this 
command. Use the Shell Password to protect yourself. To return to 
FroComm, the user must enter "EXIT" at the BOS prompt. 


There are some restrictions when using the Sihell command. For one, do 
nok run programs that write directly to the screen buffer. This will 
cause the host machine to appear to lock up. If the host machine is 
running Dosedit, CED or a similar program, backspaces, escapes and 
possibly other key sequences can lock up the machine. This problem 
arises from DOS and the other programs, not FroComm: there is nothing we 
can do about it. In addition, some machines we have tried the host mode 
on do not pipe [7/0 to the correct port. We have not yet determined if 
this is a DOS or BIOS problem, but be aware that it may occur. We 
suggest that you thoroughly test Host Mode before making it available to 
callers. 


The Gioodbye option logs the caller out and places a notice to that 
effect in the history file. 


One additional command that is not listed on the menu allows a caller to 
shut down Host Mode from the remote side. If a user enters a Ctrl-Z, he 
will be prompted for a password. FroComm uses the Shell Fassword for 
this feature. if the user correctly enters the password, he will be 
logged off and ProComm will drop out of Host Mode. This is useful if you 
begin Host Mode from a command file, and wish to continue with the 
execution of that command file. 


On the local side, the host operator has several options. You may press 
LESC? to leave host mode and return to Terminal Mode. Fress Ctrl-x to 
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FroClomm 2.4 Host Mode 
log off the current user. All other keystrokes act as if the caller 
sent them and thus allow you to help novice users through the menus. 
NOTE: Host mode, especially the S)hell command, opens a few more files. 


You must be certain that the FILES= statement in your CONFIG. SYS file is 
set high enough, preferably at FILES=20. 
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FroComm 2.4 Appendix A 


APPENDIX A ~ TERMINAL EMULATION 


Overview 


FroComm emulates a number of popular terminals. FroComm handles most of 
the standard features and many of the extended features of the terminals 
emulated. Functions of these terminals that are not emulated are still 
processed to insure that all control codes are handied properly. 


Because of the wide variety of protocol convertors on mainframe front-end 
processors, some keys may not function as expected. These emulations 
have been tested with the mainframe systems at the University of 
Missouri, Columbia and the University of California, Berkeley, as well as 
within private industry. If you encounter a problem, refer to the 
TRANSMITTED CODES column in the terminal emulation charts on the 
following pages to see if FroComm is sending the code your protocol 
convertor 16 expecting. 


If you encounter any errors in these emulations or have any questions, 
o please let us know. 
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FroComm 2.4 


Appendix 


Digital Equipment Corporation VT-100 and VT-1602 


FroComm supports the standard VT-100 and VT-102 functions. 
full/half duplex, 


functions include: 


special graphics character set, 
cursor control, 


application mode, 


US &® UE character 
erase functions, 


set/reset modes, 


Supported 

scroll region, 

sets, keypad 
insert/delete lines, 


full display attributes (including extensions for ANSI color graphics), 
programmable tabs and printer control functions. 


supported. 
commands with ESCCO?1s; 2c 
responds to the Ctrl-E 
stored for 


(VT-100 with advanced video option). 


(ENG 


keyboard macro Alt~-O. 
if ANSWER BACK is enabled in FroComm setup 


FroComm responds to the Identify and Device Attributes 


132 column mode is not 
FroComm 


enquiry function by sending the string 


Vanswerback 
(Alt-S) 


This 


mnmessage”" is sent only 
Keypad Application 


Mode functions are mapped to FroComm function keys as shown in the chart 


below, 
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FraComm supports the standard IBM 3101 Model 
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FraClomm 2.4 Appendix A 


Televideo 900 Series 


FroComm supports the standard Televideo 900 series functions. Supported 
functions include: full/half duplex, program function keys, cursor 
control, erase functions, and full display attributes. The main 
difference between the 910/920 and the 925/950 emulations is in the codes 
generated for cursor down and in control codes for display attributes. 
The special graphics character set and user loadable status line are 
supported. ; 
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FroClomm 2. 4 


FroComm supports the standard model VT-S2 functions. 
full /half 


include: 


Digital Equipment Corporation VT-52 


duplex, 


Appendix A 


functions, printer control functions and full display attributes. 
FroComm responds ta the Identify command 


a 


identification 
mapped to FroComm function 


Sequence). 


keys 


as shown 


(Esc 


in 


Tey 


with 


Ese / Zz 
Keypad Application Mode functions are 
the chart below. 


supported functions 
keypad application mode, cursor CoOmtrol, 


Ct ae 


(Standard 
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Be eiieee aes oc Twit w wire LinerPered: clk. sos eis aaah wa ee Cec Dee RCH Ie Ox OA 
Ben Pena Gl, ac 22» Keypad Application mode 1 .....00. Ox TB4F 71 
PS apts serene e as KOEYPad Application mode 2 ....«... OXiB4e72 
Sl etoey coweass Keypad Application mode 3S ..... aes OMIBAFZS 
USS Spoke eee ne Roe Keypad Application mode 4 ........ OMIB4F74 
SHLFE-FG ww wnae Keypad Application mode 5 ..aaneaae Ox 1TB4F 75 
=) 0) 0 24 Mees oe Keypad Application mode 6 ....c..0.5 Ox LRAr 7S 
SMe ia e ataiie (x vavncd = se Eeypad Application mode 7 ...... na OMAR ye 
eee te i) im Gate wes Eeypad Application mode 8 ......0. Ox LT R4F 78 
Stress ..s.... Keypad Application mode 9 ..... stem Ok eA ye 
Wot esa eae Reypad | Ano lication mode GO .. asa. Ox LB4Ar 7 
Gs eta isl atiwiia sa emer POE AN Lethe ean el CREE) acs ee we eee Ox TB4ArFSO 
Fae antaiara sx Cas See Program Function 2° 4PF2) ..eeseses Ox IB4AFS1 
len Se cal a a oa POgtam Pane cs ona PRS) 2 can sen wo Ox LT B4FS2 
Otte eels nee Frogran Runmetion 4 (PFA) 20. .s esas Ox lB4r Ss 
ol (ONS ed as a Keypad Application mode DASH ..... Ox 1lB4F 46D 
Shift-FS ....... Keypad Application mode COMMA .... OxiB4Féc 
Shift-F9 ....... Keypad Application mode FERIOD ... Ox1B4Fé6E 
Shift-FS ....... Eeypad Application mode ENTER .... OxiB4r4ap 
Copyright (C) 1986 Datastorm Technologies, Inc. 


GOS 


Mise Sarah iy 
- Hi 


ary Pe Be 


| ’ 


rc] ¥ 
r a 


eno ton? bested que eu oemeen Rae ty Labs aje aff Boyag 
asee%o , lorinos wena .s (et tas ktage. e ere Nias 
-estwdrrtits ve lqa kh flo> trie enor sinos weer ive 
brsbnete)> S\ae3 thie 4S oae8) brains wd . cry ae 

BY enaitonur sboM nokveatiqgh bsqvart a taae oh ‘nateai9 ip 
wated jaats edt of owore 2s eyed Ho to3n/t ja 


i 
i} 


Y” i * on 
63009 GaTTIMeviant MOTT Sey gaa evaM mm 
ell/Mbeniee died june etree men em atm mm ergo lite it a i i = 
POKO ee ee se geT Led m@a sob oe ee ee 
Wi MOPS nee Oe Se oencuedeee @FSA led 1eJdoeeNta Ae eee eae 
viet «© Clw - ee s-n_a\e eae b «eo 8 yow emo Nara eo 
UpHERE KO 2 4s 0 seh @ wees law ew we a ne tueeee QU ‘on 
PREVMI RO. «2. ae Woe Son) ow a rele be cowad) yop de hie 
BRASAL HO wks i's -sytherviadoe S48) AOMNND .. + Bret a 
ERASAT MW os eccavedewewcas «degen SPOR GRRE. o< ho eee ee 
AAST AGE SHACEL xO. wana devenauue COON WME «ewes BOR ae 
ANGER RO wo. cevenecwnenend SOLD Fa, DRE +i) et a al 
IRICAL HO, vss owls ola wes ypu elle alsa (PL) a Bei ree 
PEGA a was anclake cal@euhen euros SC BSMteO , «cake GUT SE 
» bine eal din deme wep wag ge ee ae Rs Cin 


7, 


INGUBG ENO Ce ee eee Lf Shon cptzast iegA Cagyver semen 6 see eee 
VAPAL KO caueeuee S&S DOM NOZIC21 (GA: DAGYOAy Abe ele 2a ewe 
PRAIHO wencveee © @bom nOobigatiagA GEOIVe Saas 5 
PTSRH THO cae » * abom naiasnt (qq beiveN + * Hern ee a pal 
PE ERO 6 sw cee © SOO NOLISIL LQG) SEY tee ewe a aad 
AVTAREI Mo ws... ceee @ GbOM nO TPaD? [GG bative® Ju. ibe) Gee 


CUFPR HO ose scenn \ @bOm ap tPRoiiqgah Gadvent Ain anes olen 
BX Pe be teeoenee | BHOm no reas! lQgah BSGQVGN i. wesleym > + dee 
PNABE INO ceeaevee © BHom ROl~eur lage Geayedt .«.eiliew © eee 
OVS@BLRO . oes -. 0 shom norseniiqqd bagyear ine ale al A! rag 


i. 
PAPE ENO awe enews CLAW TF Rel Senaeoes “6 ae we a pe a 
C™RAIMO soa e vee (299) 2 Hegtonst ee 4 ee Po 

COR Tat ; cance (OA) Coat Pons NOG, «| y/cm ere 

FCAPRIRO . vce o% . (O99) ® ncépor Wiasoe*@ .yy cen Sno 


IAIGixO ..... HAO shom notteeilqae beqyedl “ipeass ha-2e 
JO4MEEMO .... AMMOD ebom notfantliqah beaver ieee 

ad s) ... GQOIRAG ebom notyasilaqh beayvewt <<) 
QP4PHIWO ..4+ ASTWS ehem notgentiqnuk padvart 


FroCamm 2.4 


Lear Sieglar ADM 3/5 


. 


FroComm supports the standard ADM 3/5 series functions. 
functions include: full/half duplex, full character set, 
and cursor control. 


ProComm KEYS ADM 3/5 FUNCTION 


Appendix A 


Suppor tec 


erase functions, 


TRANSMITTED CODES 
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FroComm 2.4 Appendix A 


Heath/Zenith 19 


FroComm supports the standard Heath/Zenith 19 functions. Supported 
functions includes full/half duplex, full character set, program function 
keys, erase functions, cursor control, and display attributes. 
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FroComm 2.4 Appendix A 


ADDS Viewpoint 


FroComm supports the standard ADDS Viewpoint functions. Supported 
functions include: full/half duplex, erase functions, inset/delete 
functions, cursor control, and display attributes. 
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FroComm 2. 4 


FroComm supports the standard WYSE functions. 
full/half duplex, 


includes 
cursor control, 


FroCamm KEYS 


WYSE 100 


WYSE 100 FUNCTION 


erase functions, 
and display attributes. 


Appendix 


Supported functions 


TRANSMITTED CODES 
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FroaClomm 2. 4 Appendix A 


ANS I-BERS 


This is the recommended emulation for use with bulletin board systems 
that use ANSI graphics and color. The ANSI-BEBS mode processes the ANSI 
codes given in the DOS technical reference manual, and behaves in the 
same manner as the DOS ANSI.SYS device driver. (FroComm does not use the 
ANSI.SYS driver itself). This emulation is similar to the VT-160 
amulation, but the VT-100 emulation handles normal, bold, and reverse 
video in a different manner. The VT-100 keyboard mapping is used with 
this emulation. 
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APPENDIX & ~ COMMAND REFERENCE GUIDE 
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FroComm 2, 4 Appendix C 


When I’m using a multi-tasking operating system and running FroComm in 
the background, window displays bleed through to the active partition. 


ANSWwer s 


Go into the general SetUp screen and set FroComm to use the BIOS screen 
write method. It is much slower but will not cause the bleed through 
that you are experiencing. 


Questions 


When I try to use the pos gateway it says ‘Command processor not found’. 
What does this mean? . 


Answer : 


In order to use the gateway, FroComm must load a secondary copy of the 
cammand processor (COMMAND. COM). It uses the environment variable 
COMSPEC to determine the name and location of the command processor. 
COMSPEC is set at system startup to the drive, directory and program you 
booted from. Froblems can arise if you boot off a floppy, and then 
change the floppy in the boot disk drive. To use the gateway, and the 
Alt-F function, be sure that COMSFEC is set and that the command 
processor is where COMSFEC says it is. 


Cuestions 


IT can’t use the help screen because Multilink grabs the ALT-FiO keystroke 
before FroComm can get it. 


ANSWwer s 

Multilink provides an ‘escape’ keystroke to avoid that problem. Simply 
press Alt-F9 before pressing ALt-F1O and Multilink will let the @lt-Fio 
through to ProComm. 


Guestkions 


When I call online systems like CompuServe or the Source via Telenet, I 
get nothing but garbage characters on my screen. 


ANSWEI s 
When using public networks such as Telenet or Tymnet, you must either 


call in at E/7/1 (even parity, 7 data and 1 stop bits), or strip the high 
bit off each incoming character using the translate table. 


Guestions 


When IT try to run Host Mode it always thinks that somebody is onlines 
that is, it will automatically go to the "Name: " prompt and then keep 
CYE1 Ng . 


ANSWer 3 


® 
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FroaClomm 2.4 Appendix C 


You must set your modem so that it does not force carrier detect CGD 
high, or true. This is usually controlled by a dip switch on your modem. 


For example, on a Hayes external mode, set dip switch 6 to the up 
position. 


Questions 


I’m trying to get two computers running FroComm to talk to each other 
using a direct connection. What do I do? 


ANSWwer s 


You need to connect the two machines using a null modem cable. @ null 
modem cable has the usual configuration for a serial port to modem 
connection, with the exception that pins 2 and 3 must be crossed. That 
is pin 2 on one end needs to go to pin = on the other, and vice versa. 
Then make sure that @ach side is using the same line parameters. You 
should be able to talk back and forth between the machines while in 
terminal, or chat modes (like Crosstalk‘’s GO LOCAL). You May even run 
Host Mode on one machine; just remember to set the Connection Type option 
in the Host Mode Setup area to Direct. 


Guestions 


FroComm doesn’t work with my NeoClone modem that I bought in a garage 
sale in Taiwan. Why not? 


AM SWE 8 


FroClomm, by default, is set for use with Hayes compatible modems. If 
your modem is not truly Hayes compatible, you will have to change some of 
the SetUp Options, especially the Modem Initialization string and the 
Modem Dial command, to values correct for your modem. This may entail a 
little digging in your modem manual. User groups and local bulletin 
boards may be able to provide information on using your particular brand 
of modem. 
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APPENDIX DBD -— FPROCOMM 


Receive buffer size ... 
Redisplay buffer size . 


Baud rates supported .. 


File transfer protocols 


Serial ports supported 


Video buffer addresses 


Interrupt vectors used 


TECHNICAL SPECIFICATIONS 


“O48 Bytes 


19000 Bytes 
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ProComm 2. Appendix E 


APPENDIX B:- USER SUPPORTED SSOFTWARE 


User~-supported software is a means for the computing community to receive 
quality software while directly supporting software authors. It is based 
on the ideas thats 


The value and utility of software is best assessed by the 
user on his or her own system. Only after using a program 
can one really determine whether it serves personal 
applications, needs and tastes. 


The creation of independent persanal computer software can 
and should be supported by the computing community. 


Copying of programs should be encouraged, rather than 
restricted. The @ase with which software can be distributed 
outside traditional commercial channels reflects the 
strength, rather than the weakness, of electronic 
information. 


Under the user supported concept, anyone may request a copy of a 
user-supported program by sending a blank, formatted disk to the program 
author together with an addressed, postage-paid return mailer. A copy of 
the program, along with documentation on disk, will be sent by return 
mail oon the ugser’s disk. 


The program carries a notice suggesting registration for the program. You 
should register if you are going to use the program on a regular basis. 
Regardless of whether you register and use the program, you are 
encouraged to copy and distribute the program for the private, 
non-commercial, trial use of others. 


User supported software is generally not public domain material; most 
programs of this nature carry a copyright notice. Rather, the author has 
licensed you to copy and use the program under certain conditions. 
Likewise, user supported software is not intended ta be free software; it 
iS an experiment in economics, mot altruism. It is intended to provide 
quality software at a low price, while directly supporting the author, 
Without the overhead of distributors, dealers and advertising that 
produces #500 oftware packages. 


User supported software is having a hard time. More and more packages 
are being taken out of this market, and offered as more traditional, and 
expensive, products. The reason for this is simple: lots of people are 
using the packages but very few are paying for them. And without the 
support of the users, there is absolutely mo incentive for software 
authors to provide their programs in this fashion. 


There are many good reasons to register. Besides supporting the author 


(that is, paying for the software you use), you generally get better 
support and receive mailed notification of updates and other products. 
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FroComm 2. 4 Appendix E 


some authors provide diskettes and documentation with registration; due 
to our low registration fee Datastorm Technologies, Inc. does not, 
although diskettes and manuals are available at a very low price (see 
Ordering Information in the front of this manual). 


In conelusion, if you regularly use a user supported program (sometimes 
called Freeware or Shareware) and have not sent in a registration to the 
author, please do so now. Only through the financial support of users 
will this kind of inexpensive software continue to be available. 
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FroComm 2. 4 Appendix F 


APPENDIX F - PRODUCT SUFPORT 


In order to support our users, and to provide a means of distribution, we 
have implemented a bulletin board system you can use to communicate with 
LS w If you have questions or comments you may call us up and leave a 
note. In your note, describe as completely as possible the problem you 
are having. Let us know your machine configuration, your FroComm 
configuration and version and any resident software you are using. 
Describe what steps you take before the problem occurs, and exactly what 
the program does when it occurs. Tf you do not provide us with a 
complete description of the problem there is little we can do to help. 
We'll do our best to keep you up and running, but if you are not a 
registered user we do not guarantee to provide support of any kind. 


You'll always be able to find the latest version of FroComm on the BES. 
The number for our board is (314) 449-9401. The board is operational 24 
hours per day. Bue to the incredibly high volume of calls that we are 
receiving, the BES is often busy. You will probably need to put FroComm 
into auto redial and let it work for a while before you get in. We plan 
to install a second line for the benefit of registered users. 


Tf you do go online to use, please remember a few things: 


We have thousands of users to support, plus a product to maintain 
and a business to run. You will most likely not receive an 
immediate response. Please be patient. We usually take care of 
registered users in 2 or 3 days at the most. 


We do not guarantee to provide support of any kind to non- 
registered users. We do, in fact, provide many hours of support to 


non-paying users, but we do this at our discretion. Non-supporting 
users who demand support from us are usually out of luck. Flease 


be patient, and please be polite. 


In addition to our board, several 
version of FroComm. They are: 


Computer Aide BES 

Mike Johnson, Sysop 
fined. OF. (918). 493-2157 
2400 baud, 24 hours a day 


FConnecticut BRS 

John O’Boyle, Sysop 
Beeeetiarcttord, CT. <“205) S2il-1991 
2400 baud, 24 hours a day 


Underdog BBS 

Sal Manaro, Sysop 

Seattle, WA. (206) 725-9233 
“400 baud, 24 hours a day 


fine systems always carry the latest 


ATL/FIDOL 

Ken Shackelford, Sysop 
Woodstock, GA. (404) 9268-1876 
2400 baud, 24 hours a day 


TEC BBS 

Dave Staehlin, Sysop 
Albuquerque, NM, (305) G21-7379 
2400 baud, 24 hours a day 


Rowlett REES 

Dan Fardell, Sysap 

Rowlett, TX, (214) 4735-4598 
2400 baud, <4 hours a day 
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WELLSFPRING BES 

Steve Clancy, Sysop 
Irvine, CA, (714) 8546-7996 
1200 baud, Som-Bam M-F, 

“4 hours weekends 


Appendix F 


tery Pe SiG, the Source 

Mike Todd, Sysop 

The Source (800) 32346-3330 (voice) 
Mike Todd (212) 429-6104 (voice) 


FroComm is alsa found on a host of other bulletin board systems, user 


groups and the like. 
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THE PC-TALK III PROGRAM WILL BE PLACED IN DRIVE A: AND THE 
DATA DISK WILL BE PLACED IN DRIVE B: AN EXAMPLE DIRECTORY IS 
INCLUDED ON HOW TO SET UP A PHONE DIRECTORY FILE WHICH WILL 
UTILIZE DIFFERENT METHODS FOR SAVING, VERIFING, AND LOADING 
SYSTEM DATA. 


EACH TIME DATA IS SAVED FROM THE SYSTEM, WHETHER IT IS 
7SUBSCRIBER" OR INTERCONNECT, THE EXISTING FILES ON DRIVE #: 
mitt NEED TO BE DELETED. IF THIS IS NOT DONE, THEN NEW DATA 
WILL BE ADDED TO THE END OF THE DATA ALREADY ON DISK. 


III. OPERATION: "SUBSCRIBER" RAM BACKUP--CSCO9 ROARD’ 
Tica cae di ea am ee eae eee a a ae 


THE COMMAND LIST, ENTERED FROM THE IBM—-PC, IS AS FOLLOWS: 


SAVE THIS COMMAND ALLOWS THE SYSTEM MANAGER TO 
SAVE ALL THE SUBSCRIBER RECORDS AND 
RELATED INFORMATION. THE SAVE, LOAD, AND 
VERIFY ROUTINES ARE DESIGNED TO INTERACT 
WITH THE IBM-PC, WHICH WILL RESPOND TO 


DEVACE CONTROL CODES, PRIMARILY 
CONTROL-Q. 
LOAD THis COMMAND LS USED." TO) GAD THE 


“SUBSCRIBER” RECORDS FROM THE IBM-FC TO 
SYSTEM MEMORY. WHEN "LOAD" IS TYPED, THE 
OPERATOR IS REMINDED TO MAKE SURE THE 
COMPUTER IS READY. WHEN IT IS, A CARRIAGE 
RETURN TELLS SYSTEM TO START READING THE 
DATA. THE SYSTEM WILL SEND A "“CTRL-Q" AND 
THE IBM WILL READ OUT THE FIRST S—-RKECORD., 
STOPPING TO WAIT FOR ANOTHER "CTRL-O" 
FROM THE SYSTEM TO THE IBM TO READ OUT 
ANOTHER LINE. AS THE DATA IS READ IN, THE 
SYOTEM  WiLis ECHO BACK SO IT WILL APPEAR 
ON THE SCREEN. THIS CONTINUES UNTIL THE 
S-RECORD INDICATING THE END-OF-FILE IS 
READ. IF A CHECKSUM ERROR IS DETECTED IN 
AN S-RECORD, OR THE OPERATOR TYFES A 
CTRL-X, THE LOAD WILL BE ABORTED AND THE 
SYSTEM WILL JUMP TO THE STATUS ROUTINE. A 
SUCCESSFUL LOAD RETURNS TO THE "SUBS>" 
PROMPT. “SUBSCRIBER" FUNCTION IS SET TO 
INACTIVE WHEN A LOAD COMMAND IS USED. 


VERIFY THE VERIFY COMMAND IS USED TO COMPARE THE 
"SUBSCRIBER" RECORDS IN MEMORY WITH WHAT 
LS SAVED ON DISK. THE ‘OPERATION IS 
BASICALLY Te SSAME NAS “FOR THE | OAD 
COMMAND, EXCEPT THE DATA IN THE S—RECORD 
IS COMPARED WITH MEMORY INSTEAD OF STORED 
IN MEMORY. IF THE DATA IS NOT THE SAME A 
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CHECKSUM ERROR IS DETECTED IN THE 
S-RECORD, OR A CTRL-X IS TYPED, THE 
OPERATION WILL ABORT AND THE “SuUBS>" 
PROMPT WILL BE PRINTED. 


QUIT THE QUIT COMMAND Poe IGE Delo Ue xa 
"SUBSCRIBER" AND RETURN TO THE GUARDIAN 
PROMPT “GRDSS. 


COMMAND PROCEDURE 


UPON SYSTEM ACKNOWLEDGE THE SYSTEM PASSWORD WILL NEED TO BE 
ENTERED, AND THE “GRD>" PROMPT WILL APPEAR. "SUBS" IS:- THEN TO 
BE TYPED, WHEREUPON, A SECOND PASSWORD IS TO BE ENTERED. THE 
DEFAULT PASSWORD, AE TERY PINITIAU SS INSTALLATION OF" S.ALC 
SOFTWARE IS THE SYSTEM NUMBER. THIS CAN BE CHANGED AND SHOULD 
BE CHANGED TO A PASSWORD OF THE SYSTEM MANAGER'S CHO@®SE. THIS 
WILL PREVENT UN-AUTHORIZED .PERSONS FROM CORRUPTING THE 
"SUBSCRIBER" DATA. 


A WORD OF CAUTION 
DON’T TOUCH THE KEYBOARD ONCE THE DATA STREAM HAS BEGUN 


DURING A VERIFY OR LOAD SEQUENCE. THIS ACTION IS PRESENTED TO 
THE SYSTEM AS CORRUPT DATA AND A "BACKUP" ERROR WILL OCCUR. 


TO SAVE, VERIFY, AND LOAD MEMORY 
Men SAVE —ewtO SAVE UDATA»TOWDISK 
*NOTE* FOLLOW DIRECTIONS IN THE PC-TALK III DOCUMENTATION 
AS TO STRIPPING ASCII 19 AS THE DATA IS DOWNLOADED. THE 
LOAD AND VERIFY PHASES OF THIS PROCEDURE WILL NOT WORK 
WITHOUT FOLLOWING THOSE DIRECTIONS 
StErPS: — GRD OSUBS 
ENTER PASSWORD 
*OPTION LISTINGS WILL APPEAR 
SUBS >SAVE 
HIT RETURN WHEN BACKUP UNIT IS READY 
All sree SAC.RCD AP tee. SPEES): <CR> 
AT THIS TIME A STREAM OF DATA WILL BEGIN BEING PRINTED ¥0 
THE SCREEN AS WELL AS IT BEING LOADED TO THE DISK IN DRIVE 
Bs ONCE THE SAVER TS “COMPEETE, THE SYSTEM WILL SEND A “SAVE 


PONE™ MESSAGE TO THE SCREEN. HIT ALT—R TO CLOSE THE 
PeGerCD FILES TTRHESNEXT STEPWIS. TOXVERIFY THE DATA. 
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Be. VERIFY " TO VERIFY THE DATA "BACKED UP" 
SUBS >VERF 
ae HIT RETURN WHEN BACKUP UNIT IS READY 
ALT~T: BrSAC.RCD <CR>.=P4 <CR> RETRIEVED 


= THE DATA FROM DRIVE B: WILL BEGIN TO BE SENT TO THE SYSTEM 
FOR VERIFICATION. IT WILL BE ECHOED BACK ON THE SCREEN. IF 
DATA IS NOT THE SAME A CHECKSUM ERROR WILL BE DETECTED, 
THE OFERATION. WILL ABORT AND THE "SUES>" PROMPT WILL 
PRINTED TPON TrEHE S| SGREEN: The Th lS a eHAPrENS «DON TaRANre:. 
SIMPLY TRY TO VERIFY THE DATA AGAIN. IF A CHECKSUM ERROR 
IS DETECTED AGAIN, THEN THE DATA IS CORRUPT AND A "SAVE" 
WILL NEED TO BE COMPLETED ONCE MORE. NOISY PHONE LINES MAY 
CAUSE THE DATA TO BE CORRUFTED WHILE IT IS BEING RECEIVED 
BPeerTRANSMIETED. TTONCEE THEOCVERIFY “1S PCOMPLETE THE’ SUBS > 
PROMPT WILL RETURN. 


C. LOAD -— LOADING A DATA DISK TO THE SYSTEM 

SUBS >LOAD 

HIT RETURN WHEN BACKUP UNIT IS READY 

ALT-T: B:SAC.RCD <CR> =P4 <CR> RETRIEVED 
foe Dele FROM DREVEY) BStiewrtiyy BEGIN TO BE SENT TO THE 
SYSTEM. ZT WILL BE GCHEED BACK TO. THE SCREEN. IF AN ERROR 
DECURS If. CAN BE READILY SEEN ON THE SCREEN. THE LOAD WILL 
Pee PeORnieD AND THE “SYSTEM WILL JUMNF TO THE *®STATUS" 


bow rime. PaREMEMBER, (DATA 1S PACED FROM THE IBM-FPC UPON THE 
ReGCe IFT OF A CTRL-@, WHICH = <. 


IV. OPERATION: MCE RAM BACKUP--INTERCONNECT MEMORY 


Pere 15 A LIST OF COMMANDS AS ENTERED FROM THE IBM FC: 


Pox y “PUNCH SIMENORY SCONTENTS: SPECIFIED ONTO DISK. 


x=FROM ADDRESS, y=TO ADDRESS. 
am LOAD DISK CONTENTS INTO MEMORY 
V VERIFY THAT DISK EQUALS THE MEMORY 4 
te 
Q QUIT THE GUARDIAN DISK ROUTINES AND RE-ENABLE 


CALL PROCESSING 


WE WRITE ENABLE DYNAMIC RAM SO A DISK CAN RE LOADED 
INTO MEMORY 
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IL ENABLE INTERNAL LOW FAGE OF DYNAMIC RAM 
TH ENABLE INTERNAL HIGH PAGE OF DYNAMIC RAM 
1S & SET THE TAPE PORT TO BE THE SAME AS THE SYSTEM 


MANAGER PORT. 


TD SET THE TAPE PORT BACK TO’ THE AUX. PORT J4 


COMMAND PROCEDURE 


WHEN CALLING THE TRUNKING SYSTEM REMOTELY AND AFTER ENTERING 


THE 


"BILL" SECTION, A "?" WILL APPEAR. TYPE "GRDD" AND A "1" 


WILL APPEAK MOMENTARILY. THE MODEM AT THE CENTRAL SITE MAY 
See oe Ur FIN THE . PROCESS 9O0F SHIFTING FROM “BILL” TO THE 
GUARDIAN TAPE ROUTINE. THIS IS NORMAL SINCE THE MCE GOES 
THROUGH A RESET IN THE PROCESS OF TRANSFERRING CONTROL. 


SIMPLY CALL IT BACK. ONCE THE GUARDIAN PROMPT (¢!) STATE HAS 
BEEN REACHED, ANY OF THE COMMANDS LISTED ABOVE CAN BE 
ENTERED. ee 


fo STORE, VERIFY., AND LOAD. MEMORY 


A. 


PUNCH —-40 MAKE A DISK. 
Ssreros “ GRDOBILE 


?GRDD Cit, HimyY BEANE CE SenanyY 10 CALL THE SYSTEM 
BACK AT THIS POINT 1!) 


tS 
na 
[Po O-7FEP = SELEETS PAGE .O: OF DYNAMIC. KAM 

AET—K: WlemcD #1 °<CR> <CR- 

WREN (!) REAPPEARS THEN ALT—-RK. TO. END REC. 
'IH - SELECTS INTERNAL HIGH PAGE OF DYNAMIC RAM 
iP 9O=7F PEt = SELECTS PAGE 2:0F DYNAMIC RAM 

~elt—Rr IHSRED #2 CER> <CR> 

WHEN (!) REAPPEARKS TREN ALT—-R TO ‘END REC. 
LPat7O00—FFFr i SELECTS STATIC RAM 

ALTHERS + STAIMICURED #S <CR> <CR> 

WHEN (!') REAPPEARS THEN ALT-R TO END REC « 


!'Q — LEAVING GUARDIAN AND CALL PROCESSING WILL BEGIN 
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eee Y TOO VERIFY? @& DISK 
D> 
! 
STEPS: VERIFICATION IS TO BE DONE IMMEDIATELY AFTER DISK 
STORAGE. DO NOT TYPE "Q@" TO LEAVE GUARDIAN, BUT CONTINUE AS 
FOLLOWS: 
PS 
eae 
CN Ctr > 
<4 afb ts lee Rel ses 1 eSGe 
WOEN THE FICE STS eCOMPERTE THE TTXeWILL <END.FOR 
YOU AUTOMATICALLY. 
TH 


tl gate BY Se 
< ACTH=Te ‘FHS RCDIMRZPCERS 


wy ER? 
4 AET=T:-STARIC. REDS <ECR> 


'Q 
» C. LOADING A DISK BACK INTO THE MCE 
4 STEPS: GRD>BILL 

?GRDD 

iTS 

'WE 

a @ 

'L <CR> 

4 Aevate. Sl -ROD> i ceR> 
WHEN THE FILE IS COMPLETE THE TX WILL END 
AUTOMATICALLY. 

'TH 


a oc ; 
4 Aii=—Ws PHOREGD #2 °5<CR> 


ne SER (a 
4 ALT-Ts STATIC.RCD #3 <CR> 


D POAVE 


LEAVING GUARDIAN 
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UTE: WHERE <CR> IS TYPED, PLEASE BE CERTAIN TO DO A CARRIAGE 
RETURN AS MANY TIMES A@AS NOTED. UN-MARKED ENTRIES ASSUME @ 
CARRIAGE RETURN. AN UNDERSTANDING OF "WHY" WILL BE KNOWN IF 
THE CARRIAGE RETURNS ARE ENTERED IMPROPERLY. THE IL.RCD, 
IH-RCD, AND STATIC.RCD ARE INDICATORS OF FILE NAMES. "RCD" 
INDICATES "RECORD". THE NUMBERS #1, #2, AND #35 INDICATE THE 
FILES NECESSARY AND ARE NOT TO BE EYrEDS IN. 


ERROR MESSAGES 


IF WHILE VERIFYING THE DATA ON DISK WITH THE DATA IN RAM AND 
A MISMATCH OF DATA OCCURS, IT WILL NOT BE KNOWN UNTIL dil = 
MERIFY .1S -COMPLETE. ONCE COMPLETE, AND THERE WAS @ MISMATCH 
OF DATA, THE ERROR MESSAGE “MEMORY STORAGE ERROR" OF 
"CHECKSUM ERROR" WILL APPEAR ON THE SCREEN. 


DON’T FANIC — TRY THE VERIFY ROUTINE AGAIN. IT MAY HAVE BEEN 
A NOISY PHONE LINE WHICH DROPPED A DATA BIT. IF THE ERROR 
MESSAGE COMES BACK AGAIN THEN RE-PUNCH THES SDS eee aUn. 
REMEMBER, THIS MEANS MORE TIME FOR DISABLED INTERCONNECT. 


IF WHILE LOADING DATA TO THE MCB THERE IS A PROBEEM STW ith 
NOT. BE KNOWN UNTIL THE LOAD IS COMPLETE. IF THE LOAD FAILED, 
THEN THE MESSAGE "TAPE FAILURE" OR "MEMORY STORAGE ERROR" 
WILL APPEAR ON THE SCREEN. 


DON'T FANIC —- TRY THE LOAD SEQUENCE AGAIN. iF THE ERROR COMES 
BACK THEN THE DATA BASE CONTENTS COULD BE MODIFIED AT THIS 
POINT REQUIRING THE DATA BE TYPED IN TO GUARDIAN IN THE 
CONVENTIONAL MANNER. 


V. SUMMARY 


THE DESCRIBED OPERATION OF “BACKING UP" SYSTEM MEMORY IS AN 
ON-GOING PROCESS. EACH TIME PROGRAMMING IS ADDED OR MODIFIED 
ferric SYSTEM, IT WILL NEED TO BE “BACKED UF". IF THE SYSTEM 
MEMORY BECOMES LOST, THEN UP-TO-DATE DATA CAN BE LOADED TO 
teaeeoySTeM. 


THERE IS A TREMENDOUS AMOUNT OF DOCUMENTATION PRESENTED HERE 
AND UNTIL IT IS IMPLEMENTED SEVERAL TIMES AND UNDERSTOOD, 
THERE MAY BE PROBLEMS. CALL ME! I°LL HELP WORK OUT THE BUGS 
AND TRY TO PROVIDE BETTER UNDERSTANDING ON THE METHOD OF 
OPERATION. I AM LOCATED AT MOTOROLA’S AREA OFFICE IN HOUSTON. 
MY PHONE NUMBER IS 713-537-3635. 


PC-TALK III IS A PRODUCT OF "FREEWARE SOFTWARE" AND IS FREE 
TO THE USER. A CONTRIBUTION OF $35.00 IS REQUESTED BUT NOT 


MANDATORY. of ene PRICE TO) PAY FOR’ SUCH (a POWERFUL 
PROGRAM". THE INFORMATION FOR THIS CONTRIBUTION IS PRESENTED 
IN THE PC-TALK DOCUMENTATION SECTION. GOOD LUCK! 
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COMMUNICATIONS PARAMETERS  PC-TALK III 


Woon THE "“SUBSERIBER! SECTION “OF THE TRUNKING SOFTWARE, 
tmeieenteo, A. CERTAIN] CONTROLY CODE <CONTROL~-S) SENT FROM: THE 
SyoavelM WHICH IS USED TO .CONTROK® THE OPERATION OF A DATA 
RECORDER DURING LOAD. AND VERIFY FUNCTIONS. THIS CODE IS 4 
Soe READ “CODE  FORSTHE RECORDER. TO STOP READING, OUT EACH 
ENE AND] WAIT FOR Ay ®START READ" CODE FROM THE SYSTEM. ®WHEN 
HYSING THE IBM-PC AS THE BACKUP TOOL, THIS CODE IS WRITTEN ON 
THE DATA DISK. THIS IS UNSATISFACTORY BECAUSE DURING UP LOAD 
feo SCODE, 15 SENT) BACK TO THEZSYSTEM. ‘THE SYSTEM DOES NOT 
KNOW WHAT TO DO WITH THIS CODE AND AFTER A CERTAIN AMOUNT OF 
fee 9& “BACKUR” ERROR WILL OCCUR. IT IS THEN NECESSARY TO 
Seite. THIS ASCII, CODESFROM THE. INCOMING DATA, SG °IT: WILL 
Neer ce, WRITTEN “TO DISK. ~ THE  FPOLLGWING. PAGES HAVE (THE 
Peeosoomhte oe VENTS SON SP C—TALK= ato eS eLMPCENENT- THE .“STRIFPING” 
GeeroN.. THE CODE TO STRIP WILL’ BE AN ASCIT OL9.. FOLLOW THE 
DOCUMENTATION AND THE EVENTUAL LOAD AND VERIFY SEQUENCE TO 
fae eovrorem WILL WORK FINE. AcCOPY OF “FREEWARE S"“*PC-TALK ITI 
IS INCLUDED FOR IN DEPTH UNDERSTANDING OF THIS COMMUNICATIONS 
PROGRAM. ; 


fe S NECESSARY TO CREATE TWO, TYPES OF PHONE DIRECTORY FILES 
FOR OPTIMUM OPERATION. 


Penge Pome TTS) UD IRECROR YY GEILE O15) TO BE CREATED FOR. THE 
BoURSCRHIBER" SECTION OR, THE, \SGET WARE. ia eo CLUDES STE 
"PACING" AND "STRIPPING" OPTIONS REQUIRED. 


WHEN ADDING THE "PACING" OPTION, Pie NECESSARY TOCRIT. THE 
"CONTROL-@" KEYS WHEN ASKED P=. HIT RETURN AND THE "PACING" 
CHARACTER WILL APPEAR AS SHOWN. 


LE foes HTS RICE IS CREATED FOR WISE) .Wiletetos vt ae 
"INTERCONNECT" DATA COMING FROM AND GOING TO THE SYSTEM. NO 
eeeclAlL “PACING” OR “STRIPPING” OPTIONS ARE+REQUIRED. 


mae. DEFAULT. SHEET LISTS THE PROGRAM DEFAULT OPTIONS AS THEY 
mee 10 BE PROGRAMMED. PRIMARILY, THEY WILL NOT COME INTO PLAY 
AS LONG AS THE DIRECTORY OPTIONS ARE PROGRAMMED. 
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Modem dialing command = ATDT ===DIALING DIRECTORY 3 


==> 
Long distance service +#% = + +Append: 
- -# = | -Append: 

Name Phone # Comm Param Echo Mesg Strip Face 

1-SYSTEM NAME & NUMBER Sis ahs SOG | 8) N N i p= 
2-SYSTEM NAME & NUMER Sao SSS Di Ta I x7 N JN N tH 
Sort a nnn - ose r mee ee SHE 7— 1 N N N IN 
CEN oe eae ices ner mm SOC—E = 7 — it N N N N 
§------------------------- - --- --- ---- SOO-E-7-1 N N N ti 
6------ -- - - - - - - - - - - - - - - - --- = BOO-E-7-1 N N NM th 
Jocce- oer eee eee BOO-E-7- 1 N N IN in) 
@------------------------- = --- --- ---- ZOO-E-F7=-} N N N tH 
9-----------------------+-- - --- --- ---- S00-E=-7=1 N N N i 
1Q------------------~------- - en oe = 3OQ-E-7=-1 N N N 1 
1 lee ee - eer eee ee SOUKE-7=-1 IN N IN IN 
{2------------------------- - --- --- ---- SOO-E-7-1 N N NW N 
lon nn rrr rn SS SS SO0-E-7=1 N N N 4 oN 
1 4------------~------------- - --- --- ---- SOU-E-7-1 N N N " 
lB - er rn rr rn rn SS SOV=E=—7—J N N N NM 
Dial entry #:R | Or.ee Enter: to revise or add to directcry 


F / to page through directory 
to exit to terminal 


| For longa distance service, precede entry # with +/- 


R 
M for manual dialing 
bs) 
X 


Revise/add entry #:1 
Strap/convert characters (y/n)? Y 


Revise/add entry #:1 
Gide strip/emve! strimage /ISISIICSTEIATILIA TILT TITS 
.change this (y/n)7 Y 


~Revise/add entry #:1 


old strip/cnvt string: VILPGOITLOLILIIEULAT IITA 
new strip/cnvt string: 039/000 
(please reter to instructions in the documentation) 


Revise/add entry #:1 iNew string of (y/n)? Y 
Old strip/cnvt string: GE! CORAL CELA Lhd 
new strip/cnvt string: 019/000 


(please refer to instructions in the documentation) 


Y Revise/add entry a 1 
Facing? p=0 . 
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How do | low-level format an MFM or RLL drive? 


A low-level format actually does a physical format; it lays down tracks and sectors. It is the first 
format for a hard disk, and is used later to extend the life of an old drive to refresh the media. It 
wipes all information, just like reformatting a floppy disk. 


Doing a regular format on a hard drive merely re-organizes the File Allocation Table (FAT), and 
doesn't really erase the disk or lay down tracks and sectors. 


Spinrite, mentioned below, actually reads information off the disk, and re-writes it as it finishes 
formatting sectors on the disk, which is why it is not destructive like an ordinary low-level format. 
The instructions below work for small-disk Western Digital and Adaptec MFM and RLL 
controllers. Newer controllers usually use bundled software for low-level formatting. 

WARNING: DO NOT LOW-LEVEL FORMAT IDE DRIVES! 


It is best to do this from a bootable floppy. The floppy should have DEBUG.COM, FDISK.COM 
and FORMAT.COM on it. 


The old 10MB IBM XT drives have to be low-level formatted using a routine on the IBM 
Advanced Diagnostics diskette. Zenith machines use the PREP command in Zenith DOS. Other 
older machines require use of the debug utility. 
At the A:\> prompt, type: 

debug 
You will get a "-" prompt. At this point, type: 


G=C800:5 -or- for Western Digital controllers 
G=C800:800 


G=C800:CCC for Adaptec controllers. 
G=C800:5 for DTC (Data Technonolgy) controllers 
G=C800:6 for OMTI controllers 


Spinrite is a good alternative to ordinary low-level formatting, because it doesn't destroy the 
contents of a disk. However, it does not work with many kinds of drives, especially those that use 
sector translation. 
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It is best to do this from a bootable floppy. The floppy should have DEBUG.COM, FDISK.COM 
and FORMAT.COM on it. 


The old 10MB IBM XT drives have to be low-level formatted using a routine on the IBM 
Advanced Diagnostics diskette. Zenith machines use the PREP command in Zenith DOS. Other 
older machines require use of the debug utility. 
At the A:\> prompt, type: 

debug 
You will get a "-" prompt. At this point, type: 


G=C800:5 -or- for Western Digital controllers 
G=C800:800 


G=C800:CCC for Adaptec controllers. 
G=C800:5 for DTC (Data Technonolgy) controllers 
G=C800:6 for OMTI controllers 
Spinrite is a good alternative to ordinary low-level formatting, because it doesn't destroy the 


contents of a disk. However, it does not work with many kinds of drives, especially those that use 
sector translation. 
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===SET NEW DEFAULTS=== 
Fresent program defaults: 


. Baud rate 


Farity 

Data bits 
Stop bits 
Echo 
Messages 
STRIF #1 
REFLACE #1 
STAIP #2 
REFLACE #2 
STRIF #3 
REFLACE &3 
FACING Fe 
LOGGED DRIVE 
MAFGIN WIDTH 


N) 
fe) 
° 


ecooeZzZeume 
~ 
~0 


70 


SCREENDUMF FILE A: SCRNDUMP. PCT 


REDIAL DELAY 


CONNECT PROMPT 


Line 25 nelp 
Foreground 
Background 
High inten. 
Frint port 
[sit atic Sigblage 
Print width 
Comm. port 
Comm. init. 
Modem init. 
C/VR subst. 


20 


CONNECT 


Enter DY to leave unchanged —- <space*DY for ‘null’ value - <ESELD rato 
*+** Enter new values 
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Quit 
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